From 8cfc9ffc9135ecd832809359ad9ea66b5a53b143 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Fri, 5 Apr 2024 07:28:31 +0000
Subject: [PATCH] Deployed d5cd0de to master with MkDocs 1.5.3 and mike 2.0.0

---
 latest                                        |    2 +-
 master/404.html                               |   23 -
 master/benchmarks/index.html                  |   23 -
 master/changelog/index.html                   |   23 -
 master/index.html                             |   23 -
 master/nimlite/funcs/groupby.nim              |  754 +++
 master/nimlite/funcs/imputation.nim           |   16 +-
 master/nimlite/libnimlite.nim                 |    9 +
 master/nimlite/libnimlite.pyi                 |    2 +
 master/nimlite/libnimlite.so                  |  Bin 1329664 -> 1428312 bytes
 master/nimlite/numpy.nim                      |   18 +-
 master/objects.inv                            |  Bin 4135 -> 3828 bytes
 master/reference/base/index.html              |   23 -
 master/reference/config/index.html            |   23 -
 master/reference/core/index.html              |   25 +-
 master/reference/datasets/index.html          |   23 -
 master/reference/datatypes/index.html         |   23 -
 master/reference/diff/index.html              |   23 -
 master/reference/export_utils/index.html      |   23 -
 master/reference/file_reader_utils/index.html |   23 -
 master/reference/groupby_utils/index.html     | 4513 ++---------------
 master/reference/groupbys/groupbys.md         |    1 -
 master/reference/groupbys/index.html          | 1798 -------
 master/reference/import_utils/index.html      |   25 +-
 master/reference/imputation/index.html        |   23 -
 master/reference/joins/index.html             |   23 -
 master/reference/lookup/index.html            |   23 -
 master/reference/match/index.html             |   23 -
 master/reference/merge/index.html             |   23 -
 master/reference/mp_utils/index.html          |   23 -
 master/reference/nimlite/index.html           |   69 +-
 master/reference/pivots/index.html            |  183 +-
 master/reference/redux/index.html             |   23 -
 master/reference/reindex/index.html           |   23 -
 master/reference/sort_utils/index.html        |   23 -
 master/reference/sortation/index.html         |   23 -
 master/reference/tools/index.html             |   23 -
 master/reference/utils/index.html             |   23 -
 master/reference/version/index.html           |   23 -
 master/search/search_index.json               |    2 +-
 master/sitemap.xml                            |   63 +-
 master/sitemap.xml.gz                         |  Bin 395 -> 395 bytes
 master/tablite/core.py                        |    4 +-
 master/tablite/groupby_utils.py               |  212 +-
 master/tablite/groupbys.py                    |  201 -
 master/tablite/nimlite.py                     |    5 +-
 master/tablite/pivots.py                      |   22 +-
 master/tests/test_groupby_and_pivot.py        |  134 +-
 master/tests/test_groupby_utils.py            |  121 -
 master/tutorial/index.html                    |   23 -
 versions.json                                 |    8 +-
 51 files changed, 1583 insertions(+), 7179 deletions(-)
 create mode 100644 master/nimlite/funcs/groupby.nim
 delete mode 100644 master/reference/groupbys/groupbys.md
 delete mode 100644 master/reference/groupbys/index.html
 delete mode 100644 master/tablite/groupbys.py
 delete mode 100644 master/tests/test_groupby_utils.py

diff --git a/latest b/latest
index 3d7a689d..8b25206f 120000
--- a/latest
+++ b/latest
@@ -1 +1 @@
-2023.10.15
\ No newline at end of file
+master
\ No newline at end of file
diff --git a/master/404.html b/master/404.html
index 751f4fa5..aa79babc 100644
--- a/master/404.html
+++ b/master/404.html
@@ -458,8 +458,6 @@
         
       
         
-      
-        
       
         
       
@@ -691,27 +689,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="/tablite/master/reference/groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="/tablite/master/reference/import_utils/" class="md-nav__link">
         
diff --git a/master/benchmarks/index.html b/master/benchmarks/index.html
index b6ed6378..b852f523 100644
--- a/master/benchmarks/index.html
+++ b/master/benchmarks/index.html
@@ -663,8 +663,6 @@
         
       
         
-      
-        
       
         
       
@@ -896,27 +894,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../reference/groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../reference/import_utils/" class="md-nav__link">
         
diff --git a/master/changelog/index.html b/master/changelog/index.html
index ed80c861..f1803776 100644
--- a/master/changelog/index.html
+++ b/master/changelog/index.html
@@ -484,8 +484,6 @@
         
       
         
-      
-        
       
         
       
@@ -717,27 +715,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../reference/groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../reference/import_utils/" class="md-nav__link">
         
diff --git a/master/index.html b/master/index.html
index 67b74ea1..7292056d 100644
--- a/master/index.html
+++ b/master/index.html
@@ -472,8 +472,6 @@
         
       
         
-      
-        
       
         
       
@@ -705,27 +703,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="reference/groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="reference/import_utils/" class="md-nav__link">
         
diff --git a/master/nimlite/funcs/groupby.nim b/master/nimlite/funcs/groupby.nim
new file mode 100644
index 00000000..4d750d74
--- /dev/null
+++ b/master/nimlite/funcs/groupby.nim
@@ -0,0 +1,754 @@
+import nimpy
+import std/[math, tables, strutils, strformat, sequtils, enumerate, sugar, options, algorithm]
+import ../[pytypes, numpy, pymodules, nimpyext]
+import ./imputation
+
+type Accumulator = enum
+    Max, Min, Sum, First, Last, Product, Count,
+    CountUnique, Average, StandardDeviation, Median, Mode
+
+proc str2Accumulator*(str: string): Accumulator =
+    let lower = str.toLower()
+    case lower:
+    of "max": result = Max
+    of "min": result = Min
+    of "sum": result = Sum
+    of "first": result = First
+    of "last": result = Last
+    of "product": result = Product
+    of "count": result = Count
+    of "count_unique": result = CountUnique
+    of "avg": result = Average
+    of "stdev": result = StandardDeviation
+    of "median": result = Median
+    of "mode": result = Mode
+    else:
+        raise newException(ValueError, &"Unrecognized groupby accumulator - {str}.")
+
+# =============================================================
+type GroupByFunction = ref object of RootObj
+    val: Option[PY_ObjectND]
+
+method `value=`*(self: GroupByFunction, value: Option[PY_ObjectND]) {. base .}=
+    self.val = value
+method value*(self: GroupByFunction): Option[PY_ObjectND] {. base .}=
+    return self.val
+
+method update(self: GroupByFunction, value: Option[PY_ObjectND]) {.base.} =
+    raise newException(Defect, "not implemented.")
+
+proc constructGroupByFunction[T: GroupByFunction](self: T): T =
+    result = self
+
+proc newGroupByFunction(): GroupByFunction =
+    result = GroupByFunction().constructGroupByFunction()
+# =============================================================
+
+# =============================================================
+type Limit = ref object of GroupByFunction
+
+proc constructLimit[T: Limit](self: T): T =
+    result = self.constructGroupByFunction()
+
+proc newLimit(acc: Accumulator): Limit =
+    result = Limit().constructLimit()
+
+method run(self: Limit, value: Option[PY_ObjectND]) {.base.} =
+    raise newException(FieldDefect, "not implemented")
+
+method update(self: Limit, value: Option[PY_ObjectND]) =
+    if value.isNone():
+        discard
+    elif self.value.isNone():
+        self.value = value
+    else:
+        self.run(value)
+# =============================================================
+
+# =============================================================
+type GroupbyMax = ref object of Limit
+
+proc constructGroupbyMax[T: GroupbyMax](self: T): T =
+    result = self.constructLimit()
+
+proc newGroupbyMax(): GroupbyMax =
+    result = GroupbyMax().constructGroupbyMax()
+
+method run(self: GroupbyMax, value: Option[PY_ObjectND]) =
+    var v = self.value.get()
+    var vv = value.get()
+    if v.kind == vv.kind:
+        if vv > v:
+            self.value = some(vv)
+    else:
+        raise newException(Defect, "cannot find max between mixed types.")
+# =============================================================
+
+# =============================================================
+type GroupbyMin = ref object of Limit
+
+proc constructGroupbyMin[T: GroupbyMin](self: T): T =
+    result = self.constructLimit()
+
+proc newGroupbyMin(): GroupbyMin =
+    result = GroupbyMin().constructGroupbyMin()
+
+method run(self: GroupbyMin, value: Option[PY_ObjectND]) =
+    var v = self.value.get()
+    var vv = value.get()
+    if v.kind == vv.kind:
+        if vv < v:
+            self.value = some(vv)
+    else:
+        raise newException(Defect, "cannot find min between mixed types.")
+# =============================================================
+
+# =============================================================
+type GroupBySum = ref object of GroupByFunction
+
+proc constructGroupBySum[T: GroupBySum](self: T): T =
+    result = self.constructGroupByFunction()
+    result.value = some(newPY_Object(0.0))
+
+proc newGroupBySum(): GroupBySum =
+    result = GroupBySum().constructGroupBySum()
+
+method update(self: GroupBySum, value: Option[PY_ObjectND]) =
+    var unSupportedTypes = @[K_DATE, K_TIME, K_DATETIME, K_STRING]
+    if value.isNone() or value.get().kind in unSupportedTypes:
+        raise newException(ValueError, &"Sum of {value.get().kind} doesn't make sense.")
+
+    var v: float = PY_Float(self.value.get()).value
+    var vv: float
+    if value.get().kind == K_INT:
+        vv = float PY_Int(value.get()).value
+    elif value.get().kind == K_FLOAT:
+        vv = PY_Float(value.get()).value
+    self.value = some(newPY_Object(v + vv))
+# =============================================================
+
+# =============================================================
+type GroupByProduct = ref object of GroupByFunction
+
+proc constructGroupByProduct[T: GroupByProduct](self: T): T =
+    result = self.constructGroupByFunction()
+    result.value = some(newPY_Object(1.0))
+
+proc newGroupByProduct(): GroupByProduct =
+    result = GroupByProduct().constructGroupByProduct()
+
+method update(self: GroupByProduct, value: Option[PY_ObjectND]) =
+    var unSupportedTypes = @[K_DATE, K_TIME, K_DATETIME, K_STRING]
+    if value.isNone() or value.get().kind in unSupportedTypes:
+        raise newException(ValueError, &"Product of {value.get().kind} doesn't make sense.")
+
+    var v: float = PY_Float(self.value.get()).value
+    var vv: float
+    if value.get().kind == K_INT:
+        vv = float PY_Int(value.get()).value
+    elif value.get().kind == K_FLOAT:
+        vv = PY_Float(value.get()).value
+    self.value = some(newPY_Object(v * vv))
+# =============================================================
+
+# =============================================================
+type GroupByFirst = ref object of GroupByFunction
+    isSet: bool = false
+
+proc constructGroupByFirst[T: GroupByFirst](self: T): T =
+    result = self.constructGroupByFunction()
+
+proc newGroupByFirst(): GroupByFirst =
+    result = GroupByFirst().constructGroupByFirst()
+
+method update(self: GroupByFirst, value: Option[PY_ObjectND]) =
+    if not self.isSet:
+        self.value = value
+        self.isSet = true
+# =============================================================
+
+# =============================================================
+type GroupByLast = ref object of GroupByFunction
+
+proc constructGroupByLast[T: GroupByLast](self: T): T =
+    result = self.constructGroupByFunction()
+    result.value = some(newPY_Object())
+
+proc newGroupByLast(): GroupByLast =
+    result = GroupByLast().constructGroupByLast()
+
+method update(self: GroupByLast, value: Option[PY_ObjectND]) =
+    self.value = value
+# =============================================================
+
+# =============================================================
+type GroupByCount = ref object of GroupByFunction
+
+proc constructGroupByCount[T: GroupByCount](self: T): T =
+    result = self.constructGroupByFunction()
+    result.value = some(newPY_Object(0))
+
+proc newGroupByCount(): GroupByCount =
+    result = GroupByCount().constructGroupByCount()
+
+method update(self: GroupByCount, value: Option[PY_ObjectND]) =
+    var v: int = int PY_Int(self.value.get()).value
+    self.value = some(newPY_Object(v + 1))
+# =============================================================
+
+# =============================================================
+type GroupByCountUnique = ref object of GroupByFunction
+    items: seq[PY_ObjectND] = @[]
+
+proc constructGroupByCountUnique[T: GroupByCountUnique](self: T): T =
+    result = self.constructGroupByFunction()
+    result.value = some(newPY_Object(0))
+
+proc newGroupByCountUnique(): GroupByCountUnique =
+    result = GroupByCountUnique().constructGroupByCountUnique()
+
+method update(self: GroupByCountUnique, value: Option[PY_ObjectND]) =
+    if value.get() notin self.items:
+        self.items.add(value.get())
+    self.value = some(newPY_Object(len(self.items)))
+# =============================================================
+
+# =============================================================
+type GroupByAverage = ref object of GroupByFunction
+    sum: float = 0
+    count: int = 0
+
+proc constructGroupByAverage[T: GroupByAverage](self: T): T =
+    result = self.constructGroupByFunction()
+    result.value = some(newPY_Object(0.0))
+
+proc newGroupByAverage(): GroupByAverage =
+    result = GroupByAverage().constructGroupByAverage()
+
+method update(self: GroupByAverage, value: Option[PY_ObjectND]) =
+    var unSupportedTypes = @[K_DATE, K_TIME, K_DATETIME, K_STRING]
+    if value.isNone() or value.get().kind in unSupportedTypes:
+        raise newException(ValueError, &"Average of {value.get().kind} doesn't make sense.")
+    var v: float
+    if value.get().kind == K_INT:
+        v = float PY_Int(value.get()).value
+    else:
+        v = PY_Float(value.get()).value
+    self.sum += v
+    self.count += 1
+    self.value = some(newPY_Object(self.sum / float self.count))
+# =============================================================
+
+# =============================================================
+type GroupByStandardDeviation = ref object of GroupByFunction
+    count: int = 0
+    mean: float = 0.0
+    c: float = 0.0
+#[
+    Uses J.P. Welfords (1962) algorithm.
+    For details see https://en.wikipedia.org/wiki/Algorithms_for_calculating_variance#Online_algorithm
+]#
+proc constructGroupByStandardDeviation[T: GroupByStandardDeviation](self: T): T =
+    result = self.constructGroupByFunction()
+    result.value = some(newPY_Object(0.0))
+
+proc newGroupByStandardDeviation(): GroupByStandardDeviation =
+    result = GroupByStandardDeviation().constructGroupByStandardDeviation()
+
+method value*(self: GroupByStandardDeviation): Option[PY_ObjectND] =
+    if self.count <= 1:
+        return some(newPY_Object(0.0))
+    var variance = self.c / float(self.count - 1)
+    return some(newPY_Object(pow(variance, (1/2))))
+
+method update(self: GroupByStandardDeviation, value: Option[PY_ObjectND]) =
+    var unSupportedTypes = @[K_DATE, K_TIME, K_DATETIME, K_STRING]
+    if value.isNone() or value.get().kind in unSupportedTypes:
+        raise newException(ValueError, &"Std.dev. of {value.get().kind} doesn't make sense.")
+    self.count += 1
+    var v: float
+    if value.get().kind == K_INT:
+        v = float(PY_Int(value.get()).value)
+    else:
+        v = PY_Float(value.get()).value
+    var dt: float = v - self.mean
+    self.mean += dt / float(self.count)
+    self.c += dt * (v - self.mean)
+# =============================================================
+
+# =============================================================
+const PARITY_TABLE = {
+    K_NONETYPE: 0,
+    K_BOOLEAN: 1,
+    K_INT: 2,
+    K_FLOAT: 2,
+    K_TIME: 3,
+    K_DATE: 4,
+    K_DATETIME: 5,
+}.toTable()
+
+type Histogram = ref object of GroupByFunction
+    hist*: OrderedTable[PY_ObjectND, int] = initOrderedTable[PY_ObjectND, int]()
+
+proc constructHistogram[T: Histogram](self: T): T =
+    result = self.constructGroupByFunction()
+
+proc newHistogram(): Histogram =
+    result = Histogram().constructHistogram()
+
+proc cmpNonText(this, other: (PY_ObjectND, int)): int =
+    let typ = system.cmp[int](PARITY_TABLE[this[0].kind], PARITY_TABLE[other[0].kind])
+    if typ == 0:
+        let val = system.cmp[float](this[0].toFloat(), other[0].toFloat())
+        if val == 0:
+            return system.cmp[int](this[1], other[1])
+        return val
+    return typ
+    
+proc cmpText(this, other: (PY_String, int)): int =
+    let val = system.cmp[string](this[0].value, other[0].value)
+    if val == 0:
+        return system.cmp[int](this[1], other[1])
+    return val
+
+method sortedHistogram(self: Histogram): seq[(PY_ObjectND, int)] {.base.} =
+    var text: seq[(PY_String, int)] = @[]
+    var nonText: seq[(PY_ObjectND, int)] = @[]
+
+    for (k, v) in self.hist.pairs:
+        if k.kind == K_STRING:
+            text.add((PY_String(k), v))
+        else:
+            nonText.add((k, v))
+    
+    nonText.sort(cmpNonText)
+    text.sort(cmpText)
+
+    var res: seq[(PY_ObjectND, int)] = @[]
+    for (v, c) in nonText:
+        res.add((v, c))
+    for (v, c) in text:
+        res.add((v, c))
+    return res
+
+method update(self: Histogram, value: Option[PY_ObjectND]) =
+    var v = value.get()
+    if self.hist.hasKey(v):
+        self.hist[v] += 1
+    else:
+        self.hist[v] = 1
+# =============================================================
+
+# =============================================================
+type GroupByMedian = ref object of Histogram
+
+proc constructGroupByMedian[T: GroupByMedian](self: T): T =
+    result = self.constructHistogram()
+
+proc newGroupByMedian(): GroupByMedian =
+    result = GroupByMedian().constructGroupByMedian()
+
+template castToFloat(n: PY_ObjectND): float =
+    if n.kind == K_INT:
+        float PY_Int(n).value
+    else:
+        PY_Float(n).value
+
+method value*(self: GroupByMedian): Option[PY_ObjectND] =
+    var keys = len(self.hist)
+    if keys == 1:
+        for k in self.hist.keys():
+            return some(k)
+    elif keys mod 2 == 0:
+        var 
+            A: PY_ObjectND
+            B: PY_ObjectND
+            total: int = 0
+            counts: seq[int] = collect:
+                for v in self.hist.values:
+                    v
+            midpoint: float = sum(counts) / 2
+        for (k, v) in self.sortedHistogram():
+            total += v
+            A = B
+            B = k
+            if float(total) > midpoint:
+                var s = @[K_INT, K_FLOAT]
+                if A.kind notin s or B.kind notin s:
+                    raise newException(ValueError, "Can't find median of non numbers.")
+                return some(newPY_Object((castToFloat(A) + castToFloat(B)) / 2.0))
+    else:
+        var 
+            counts: seq[int] = collect:
+                for v in self.hist.values:
+                    v
+            midpoint: float = sum(counts) / 2
+            total = 0
+        for (k, v) in self.sortedHistogram():
+            total += v
+            if float(total) > midpoint:
+                return some(k)
+# =============================================================
+
+# =============================================================
+type GroupByMode = ref object of Histogram
+
+proc constructGroupByMode[T: GroupByMode](self: T): T =
+    result = self.constructHistogram()
+
+proc newGroupByMode(): GroupByMode =
+    result = GroupByMode().constructGroupByMode()
+
+proc cmpNonText(this, other: (int, PY_ObjectND)): int =
+    let cnt = system.cmp[int](this[0], other[0])
+    if cnt == 0:
+        let typ = system.cmp[int](PARITY_TABLE[this[1].kind], PARITY_TABLE[other[1].kind])
+        if typ == 0:
+            return system.cmp[float](this[1].toFloat(), other[1].toFloat())
+        return typ
+    return cnt
+    
+proc cmpText(this, other: (int, PY_String)): int =
+    let cnt = system.cmp[int](this[0], other[0])
+    if cnt == 0:
+        return system.cmp[string](this[1].value, other[1].value)
+    return cnt
+
+proc sortedHistogramReversed(self: Histogram, order: SortOrder = SortOrder.Ascending): seq[(int, PY_ObjectND)] =
+    var text: seq[(int, PY_String)] = @[]
+    var nonText: seq[(int, PY_ObjectND)] = @[]
+
+    for (k, cnt) in self.hist.pairs:
+        if k.kind == K_STRING:
+            text.add((cnt, PY_String(k)))
+        else:
+            nonText.add((cnt, k))
+    
+    nonText.sort(cmpNonText, order)
+    text.sort(cmpText, order)
+
+    var res: seq[(int, PY_ObjectND)] = @[]
+    for (cnt, v) in nonText:
+        res.add((cnt, v))
+    for (cnt, v) in text:
+        res.add((cnt, v))
+    return res
+
+method value*(self: GroupByMode): Option[PY_ObjectND] =
+    var hist = self.sortedHistogramReversed(SortOrder.Descending)
+    var (_, mostFreq) = hist[0]
+    return some(mostFreq)
+# =============================================================
+
+
+# =============================================================
+# =============================================================
+# =============================================================
+
+proc getGroupByFunction(acc: Accumulator): GroupByFunction =
+    case acc:
+    of Accumulator.Max:
+        return newGroupbyMax()
+    of Accumulator.Min:
+        return newGroupbyMin()
+    of Accumulator.Sum:
+        return newGroupBySum()
+    of Accumulator.Product:
+        return newGroupByProduct()
+    of Accumulator.First:
+        return newGroupByFirst()
+    of Accumulator.Last:
+        return newGroupByLast()
+    of Accumulator.Count:
+        return newGroupByCount()
+    of Accumulator.CountUnique:
+        return newGroupByCountUnique()
+    of Accumulator.Average:
+        return newGroupByAverage()
+    of Accumulator.StandardDeviation:
+        return newGroupByStandardDeviation()
+    of Accumulator.Median:
+        return newGroupByMedian()
+    of Accumulator.Mode:
+        return newGroupByMode()
+    else:
+        raise newException(ValueError, &"unknown accumulator - {acc}")
+
+proc getPages(indices: seq[seq[PY_ObjectND]], columnIndex: int): seq[nimpy.PyObject] =
+    let
+        m = modules()
+        tabliteConfig = m.tablite.modules.config.classes.Config
+        pageSize = tabliteConfig.PAGE_SIZE.to(int)
+        pageCount = int ceil(len(indices) / pageSize)
+        wpid = tabliteConfig.pid.to(string)
+        tablitDir = m.builtins.toStr(tabliteConfig.workdir)
+        workdir = &"{tablitDir}/{wpid}"
+
+    var
+        s: seq[PY_ObjectND] = newSeq[PY_ObjectND](pageSize)
+        pages: seq[nimpy.PyObject] = newSeqOfCap[nimpy.PyObject](pageCount)
+        ix = 0
+
+    proc save(values: seq[PY_ObjectND], pageLen: int) =
+        let pid = m.tablite.modules.base.classes.SimplePageClass.next_id(workdir).to(string)
+        var ndarr = newNDArray(values[0 ..< pageLen])
+        ndarr.save(workdir, pid)
+        var page = newPyPage(ndarr, workdir, pid)
+        pages.add(page)
+
+    for arr in indices:
+        s[ix] = arr[columnIndex]
+        inc ix
+        if ix == pageSize: # create page
+            save(s, ix)
+            ix = 0
+    if ix > 0:
+        save(s, ix)
+
+    return pages
+
+proc getPages(values: seq[PY_ObjectND]): seq[nimpy.PyObject] =
+    let
+        m = modules()
+        tabliteConfig = m.tablite.modules.config.classes.Config
+        pageSize = tabliteConfig.PAGE_SIZE.to(int)
+        pageCount = int ceil(len(values) / pageSize)
+        wpid = tabliteConfig.pid.to(string)
+        tablitDir = m.builtins.toStr(tabliteConfig.workdir)
+        workdir = &"{tablitDir}/{wpid}"
+
+    var
+        s: seq[PY_ObjectND] = newSeq[PY_ObjectND](pageSize)
+        pages: seq[nimpy.PyObject] = newSeqOfCap[nimpy.PyObject](pageCount)
+        ix = 0
+
+    proc save(values: seq[PY_ObjectND], pageLen: int) =
+        let pid = m.tablite.modules.base.classes.SimplePageClass.next_id(workdir).to(string)
+        var ndarr = newNDArray(values[0 ..< pageLen])
+        ndarr.save(workdir, pid)
+        var page = newPyPage(ndarr, workdir, pid)
+        pages.add(page)
+
+    for v in values:
+        s[ix] = v
+        inc ix
+        if ix == pageSize: # create page
+            save(s, ix)
+            ix = 0
+    if ix > 0:
+        save(s, ix)
+
+    return pages
+
+iterator pageZipper[T](iters: OrderedTable[string, seq[T]]): seq[T] =
+    var allIters = newSeq[iterator(): T]()
+
+    proc makeIterable(iterable: seq[T]): auto =
+        return iterator(): auto =
+            for v in iterable:
+                yield v
+
+    var res: seq[T] = @[]
+    var finished = false
+
+    for it in iters.values:
+        let i = makeIterable(it)
+
+        allIters.add(i)
+
+        res.add(i())
+        finished = finished or finished(i)
+
+    while not finished:
+        yield res
+
+        res = newSeqOfCap[T](allIters.len)
+
+        for i in allIters:
+            res.add(i())
+            finished = finished or finished(i)
+
+iterator iteratePages(paths: seq[string]): seq[PY_ObjectND] =
+    let pages = collect: (for p in paths: readNumpy(p))
+
+    var allIters = newSeq[iterator(): PY_ObjectND]()
+    var res: seq[PY_ObjectND] = @[]
+    var finished = false
+
+    proc makeIterable(page: BaseNDArray): auto =
+        return iterator(): auto =
+            for v in page.iterateObjectPage:
+                yield v
+
+    for pg in pages:
+        let i = makeIterable(pg)
+
+        allIters.add(i)
+
+        res.add(i())
+        finished = finished or finished(i)
+
+    while not finished:
+        yield res
+
+        res = newSeqOfCap[PY_ObjectND](allIters.len)
+
+        for i in allIters:
+            res.add(i())
+            finished = finished or finished(i)
+
+proc groupby*(T: nimpy.PyObject, keys: seq[string], functions: seq[(string, Accumulator)], tqdm: nimpy.PyObject = modules().tqdm.classes.TqdmClass): nimpy.PyObject =
+    let
+        m = modules()
+        tabliteBase = m.tablite.modules.base
+        tabliteConfig = m.tablite.modules.config.classes.Config
+        pid = tabliteConfig.pid.to(string)
+        workDir = m.builtins.toStr(tabliteConfig.workdir)
+        pidDir = &"{workDir}/{pid}"
+
+    if (len(keys) + len(functions)) == 0:
+        raise newException(ValueError, "No keys or functions?")
+
+    var unique_keys: seq[string] = @[]
+    for k in keys:
+        if k notin unique_keys:
+            unique_keys.add(k)
+        else:
+            raise newException(ValueError, "duplicate keys found across rows and columns.")
+
+    # only keys will produce unique values for each key group.
+    if len(keys) > 0 and len(functions) == 0:
+        var indexes: seq[seq[PY_ObjectND]] = collect:
+            for a in T.index(keys).keys():
+                a
+
+        var newTable = m.tablite.classes.TableClass!()
+        for (i, k) in enumerate(keys):
+            var pages = getPages(indexes, i)
+            var column = tabliteBase.classes.ColumnClass!(pidDir)
+            for p in pages:
+                discard column.pages.append(p)
+            newTable[keys[i]] = column
+        return newTable
+
+    # grouping is required...
+    # 1. Aggregate data.
+    var columnNames: seq[string] = keys
+    for (cn, acc) in functions:
+        if cn notin columnNames:
+            columnNames.add(cn)
+
+    # var relevantT = T.slice(columnNames)
+    var columnsPaths: OrderedTable[string, seq[string]] = collect(initOrderedTable()):
+        for cn in columnNames:
+            {cn: tabliteBase.collectPages(T[cn])}
+
+    for cn in columnNames:
+        var pages: seq[string] = tabliteBase.collectPages(T[cn])
+        columnsPaths[cn] = pages
+
+    var aggregationFuncs = initOrderedTable[seq[PY_ObjectND], seq[(string, GroupByFunction)]]()
+    for pagesZipped in pageZipper(columnsPaths):
+        for row in iteratePages(pagesZipped):
+            var d = collect(initOrderedTable()):
+                for (i, v) in enumerate(row):
+                    {columnNames[i]: v}
+            var key: seq[PY_ObjectND] = collect:
+                for k in keys:
+                    d[k]
+            var aggFuncs: seq[(string, GroupByFunction)]
+            if aggregationFuncs.hasKey(key):
+                aggFuncs = aggregationFuncs[key]
+            else:
+                aggregationFuncs[key] = collect:
+                    for (cn, acc) in functions:
+                        (cn, getGroupByFunction(acc))
+                aggFuncs = aggregationFuncs[key]
+            for (cn, fun) in aggFuncs:
+                fun.update(some(d[cn]))
+    
+    var keysFuncCols = keys
+    for (cn, acc) in functions:
+        keysFuncCols.add(cn)
+    var cols: seq[seq[PY_ObjectND]] = collect:
+        for _ in keysFuncCols:
+            newSeq[PY_ObjectND]()
+    for (keyTup, funcs) in aggregationFuncs.pairs:
+        for (ix, keyVal) in enumerate(keyTup):
+            cols[ix].add(keyVal)
+        var start: int = len(keys)
+        for (ix, p) in enumerate(start, funcs):
+            var f: GroupByFunction = p[1]
+            cols[ix].add(f.value.get())
+    
+    var newNames: seq[string] = keys
+    for (cn, f) in functions:
+        newNames.add(&"{f}({cn})")
+    var newTable = m.tablite.classes.TableClass!()
+    
+    for (cn, data) in zip(newNames, cols):
+        var column = tabliteBase.classes.ColumnClass!(pidDir)
+        var pages = getPages(data)
+        for p in pages:
+            discard column.pages.append(p)
+        newTable[cn] = column
+
+    return newTable
+
+# when appType != "lib":
+#     modules().tablite.modules.config.classes.Config.PAGE_SIZE = 1
+#     let columns = modules().builtins.classes.DictClass!()
+
+
+    # columns["A"] = @[nimValueToPy(nil), nimValueToPy(2), nimValueToPy(2), nimValueToPy(4), nimValueToPy(nil)]
+    # columns["B"] = @[nimValueToPy(2), nimValueToPy(3), nimValueToPy(4), nimValueToPy(7), nimValueToPy(6)]
+
+    # columns["a"] = @[0, 1, 2, 3, 4, 0, 1, 2, 3, 4]
+    # columns["b"] = @[0, 1, 2, 3, 4, 0, 1, 2, 3, 4]
+    # columns["c"] = @[0, 1, 2, 3, 4, 0, 1, 2, 3, 4]
+    # columns["d"] = @[0, 1, 2, 3, 4, 0, 1, 2, 3, 4]
+    # columns["e"] = @[0, 1, 2, 3, 4, 0, 1, 2, 3, 4]
+    # columns["f"] = @[1, 4, 5, 10, 13, 1, 4, 7, 10, 13]
+    # columns["g"] = @[0, 1, 8, 27, 64, 0, 1, 8, 27, 64]
+
+    # columns["a"] = @[1, 1, 1, 1, 1, 1]
+    # columns["b"] = @[-2, -1, 0, 1, 2, 3]
+
+    # let table = modules().tablite.classes.TableClass!(columns = columns)
+
+    # discard table.show()
+
+    # var r = table.groupby(keys = @["A"], functions = @[]) # None, 2, 4
+    # var r = table.groupby(keys = @["A", "B"], functions = @[]) # just like original
+    # var r = table.groupby(keys = @["A", "B"], functions = @[("A", Accumulator.Min)]) # Min(A) None, 2, 2, 4, None
+    # var r = table.groupby(keys = @["A", "B"], functions = @[("A", Accumulator.Max)]) # Max(A) None, 2, 2, 4, None
+    # var r = table.groupby(keys = @["A"], functions = @[("B", Accumulator.Sum)]) # 8, 7, 7
+    # var r = table.groupby(keys = @["A"], functions = @[("B", Accumulator.Product)]) # 12, 12, 7
+    # var r = table.groupby(keys = @["A"], functions = @[("B", Accumulator.First)]) # 2, 3, 7
+    # var r = table.groupby(keys = @["A"], functions = @[("B", Accumulator.Last)]) # 6, 4, 7
+    # var r = table.groupby(keys = @["A"], functions = @[("B", Accumulator.Count)]) # 2, 2, 1
+    # var r = table.groupby(keys = @["A"], functions = @[("B", Accumulator.CountUnique)]) # 2, 2, 1
+    # var r = table.groupby(keys = @["A"], functions = @[("B", Accumulator.Average)]) # 4, 3.5, 7
+    # var r = table.groupby(keys = @["A"], functions = @[("B", Accumulator.StandardDeviation)]) # 2.8284, 0.7071, 0.0
+    # var r = table.groupby(keys = @["A"], functions = @[("B", Accumulator.Median)]) # 4, 3.5, 7
+    # var r = table.groupby(keys = @["A"], functions = @[("B", Accumulator.Mode)]) # 6, 4, 7
+
+    # var r = table.groupby(keys = @["a", "b"], functions = @[
+    #     ("f", Accumulator.Max),
+    #     ("f", Accumulator.Min),
+    #     ("f", Accumulator.Sum),
+    #     ("f", Accumulator.Product),
+    #     ("f", Accumulator.First),
+    #     ("f", Accumulator.Last),
+    #     ("f", Accumulator.Count),
+    #     ("f", Accumulator.CountUnique),
+    #     ("f", Accumulator.Average),
+    #     ("f", Accumulator.StandardDeviation),
+    #     ("a", Accumulator.StandardDeviation),
+    #     ("f", Accumulator.Median),
+    #     ("f", Accumulator.Mode),
+    #     ("g", Accumulator.Median),
+    # ])
+
+    # var r = table.groupby(keys = @["a"], functions = @[("b", Accumulator.Max)])
+    # discard r.show()
diff --git a/master/nimlite/funcs/imputation.nim b/master/nimlite/funcs/imputation.nim
index 35e41975..ca12d314 100644
--- a/master/nimlite/funcs/imputation.nim
+++ b/master/nimlite/funcs/imputation.nim
@@ -25,14 +25,14 @@ proc uniqueColumnValues(pagePaths: seq[string]): seq[PY_ObjectND] =
             uniqueVals.add(v)
     result = uniqueVals
 
-method toFloat(self: PY_ObjectND): float {.base, inline.} = implement("PY_ObjectND.`toFloat` must be implemented by inheriting class: " & $self.kind)
-method toFloat(self: PY_NoneType): float = -Inf
-method toFloat(self: PY_Boolean): float = float(self.value)
-method toFloat(self: PY_Int): float = float(self.value)
-method toFloat(self: PY_Float): float = self.value
-method toFloat(self: PY_Date): float = self.value.toTime().toUnixFloat()
-method toFloat(self: PY_Time): float = self.value.duration2Seconds()
-method toFloat(self: PY_DateTime): float = self.value.toTime().toUnixFloat()
+method toFloat*(self: PY_ObjectND): float {.base, inline.} = implement("PY_ObjectND.`toFloat` must be implemented by inheriting class: " & $self.kind)
+method toFloat*(self: PY_NoneType): float = -Inf
+method toFloat*(self: PY_Boolean): float = float(self.value)
+method toFloat*(self: PY_Int): float = float(self.value)
+method toFloat*(self: PY_Float): float = self.value
+method toFloat*(self: PY_Date): float = self.value.toTime().toUnixFloat()
+method toFloat*(self: PY_Time): float = self.value.duration2Seconds()
+method toFloat*(self: PY_DateTime): float = self.value.toTime().toUnixFloat()
 
 proc cmpNonText(this, other: PY_ObjectND): int =
     let r = system.cmp[int](PARITY_TABLE[this.kind], PARITY_TABLE[other.kind])
diff --git a/master/nimlite/libnimlite.nim b/master/nimlite/libnimlite.nim
index 937b562c..aeb34d91 100644
--- a/master/nimlite/libnimlite.nim
+++ b/master/nimlite/libnimlite.nim
@@ -152,3 +152,12 @@ when isLib:
                 raise newException(ValueError, "unrecognized type.")
         return nearestNeighbourImputation(T, sources, miss, targets, tqdm)
     # --------  IMPUTATION  -----------
+    
+    # --------   GROUPBY  -----------
+    import funcs/groupby as gb
+    proc groupby(T: nimpy.PyObject, keys: seq[string], functions: seq[(string, string)], tqdm: nimpy.PyObject): nimpy.PyObject {. exportpy .} =
+        var funcs = collect:
+            for (cn, fn) in functions:
+                (cn, str2Accumulator(fn))
+        return gb.groupby(T, keys, funcs, tqdm)
+    # --------   GROUPBY  -----------
\ No newline at end of file
diff --git a/master/nimlite/libnimlite.pyi b/master/nimlite/libnimlite.pyi
index f251eb2d..eaee6a06 100644
--- a/master/nimlite/libnimlite.pyi
+++ b/master/nimlite/libnimlite.pyi
@@ -33,6 +33,8 @@ def collect_text_reader_page_info_task(task_info, task):
 def nearest_neighbour(T, sources, missing, targets, tqdm):
     pass
 
+def groupby(T, keys, functions, tqdm):
+    pass
 
 def filter(table, expressions, type, tqdm):
     pass
diff --git a/master/nimlite/libnimlite.so b/master/nimlite/libnimlite.so
index f142d22ae508e1e64d328c173c5ce85a59cce2e9..2c4e3dfe082fe89288ee0fd0279c68451b4b729d 100644
GIT binary patch
literal 1428312
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%0AcOK9te8Ygu@IZ@QHdw+uViOcVFws*hx3M(4
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%0A5@BepQ
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%0DQjG2e0}gmULGQr|vQylOc;h~`b95j#H)
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

literal 1329664
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%0An#Py0U*X
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%0Atv9m*LF)UFaQMOo%T9-_WON;kwjXe1Gr%gzHL>x
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
Jgoj^0{vYr!^nd^W

diff --git a/master/nimlite/numpy.nim b/master/nimlite/numpy.nim
index 4f153805..532f000a 100644
--- a/master/nimlite/numpy.nim
+++ b/master/nimlite/numpy.nim
@@ -1,4 +1,4 @@
-import std/[os, unicode, strutils, sugar, times, tables, enumerate, sequtils, paths, hashes]
+import std/[os, unicode, strutils, sugar, times, tables, enumerate, sequtils, paths, hashes, strformat]
 from std/macros import bindSym
 from std/typetraits import name
 from std/math import ceil
@@ -1429,6 +1429,22 @@ method toHash(self: PY_String): Hash = hash((self.kind, self.value))
 proc hash*(self: PY_ObjectND): Hash = self.toHash()
 proc hash*(self: seq[PY_ObjectND]): Hash = hash(self, 0, self.high)
 
+proc slice*(table: nimpy.PyObject, columnNames: openArray[string]): nimpy.PyObject =
+    let
+        m = modules()
+        tabliteBase = m.tablite.modules.base
+        tabliteConf = m.tablite.modules.config.classes.Config
+        pid: string = tabliteConf.pid.to(string)
+        workDir: string = m.toStr(tabliteConf.workdir)
+        pidDir: string = &"{workDir}/{pid}"
+    
+    var t = m.tablite.classes.TableClass!()
+    for name in columnNames:
+        var c = tabliteBase.classes.ColumnClass!(pidDir)
+        for p in table[name].pages:
+            discard c.pages.append(p)
+        t[name] = c
+    return t
 
 proc index*(table: nimpy.PyObject, columnNames: openArray[string]): TableIndices =
     var d = initOrderedTable[seq[PY_ObjectND], seq[int]]()
diff --git a/master/objects.inv b/master/objects.inv
index 11f4cff2d768d8e1468a99dc5eac616562523ad4..6d942a2e4f154d740e7a4c1763467d8e9a81d3aa 100644
GIT binary patch
delta 3740
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
Gcq`z8T~AH`

delta 4049
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
DIf~a_

diff --git a/master/reference/base/index.html b/master/reference/base/index.html
index ad7c8e92..3b3e2119 100644
--- a/master/reference/base/index.html
+++ b/master/reference/base/index.html
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -1829,27 +1827,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
diff --git a/master/reference/config/index.html b/master/reference/config/index.html
index dc533948..66cb0258 100644
--- a/master/reference/config/index.html
+++ b/master/reference/config/index.html
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -971,27 +969,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
diff --git a/master/reference/core/index.html b/master/reference/core/index.html
index 7a6af2b7..1eec60bc 100644
--- a/master/reference/core/index.html
+++ b/master/reference/core/index.html
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -1526,27 +1524,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
@@ -8275,7 +8252,7 @@ <h6 id="tablite.core.Table.groupby" class="doc doc-heading">
 <span class="sd">        https://github.com/root-11/tablite/blob/master/tests/test_groupby.py</span>
 
 <span class="sd">    &quot;&quot;&quot;</span>
-    <span class="k">return</span> <span class="n">groupbys</span><span class="o">.</span><span class="n">groupby</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">keys</span><span class="p">,</span> <span class="n">functions</span><span class="p">,</span> <span class="n">tqdm</span><span class="o">=</span><span class="n">tqdm</span><span class="p">,</span> <span class="n">pbar</span><span class="o">=</span><span class="n">pbar</span><span class="p">)</span>
+    <span class="k">return</span> <span class="n">_groupby</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">keys</span><span class="p">,</span> <span class="n">functions</span><span class="p">,</span> <span class="n">tqdm</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
           </details>
   </div>
diff --git a/master/reference/datasets/index.html b/master/reference/datasets/index.html
index b5984cce..bbc322c9 100644
--- a/master/reference/datasets/index.html
+++ b/master/reference/datasets/index.html
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -791,27 +789,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
diff --git a/master/reference/datatypes/index.html b/master/reference/datatypes/index.html
index 45daec42..c13e276a 100644
--- a/master/reference/datatypes/index.html
+++ b/master/reference/datatypes/index.html
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -1436,27 +1434,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
diff --git a/master/reference/diff/index.html b/master/reference/diff/index.html
index f4edd8d6..9cf2f00b 100644
--- a/master/reference/diff/index.html
+++ b/master/reference/diff/index.html
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -791,27 +789,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
diff --git a/master/reference/export_utils/index.html b/master/reference/export_utils/index.html
index 74c304df..1f25ef37 100644
--- a/master/reference/export_utils/index.html
+++ b/master/reference/export_utils/index.html
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -887,27 +885,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
diff --git a/master/reference/file_reader_utils/index.html b/master/reference/file_reader_utils/index.html
index b5498c1d..068e1783 100644
--- a/master/reference/file_reader_utils/index.html
+++ b/master/reference/file_reader_utils/index.html
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -1001,27 +999,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
diff --git a/master/reference/groupby_utils/index.html b/master/reference/groupby_utils/index.html
index aa224e97..3354ee59 100644
--- a/master/reference/groupby_utils/index.html
+++ b/master/reference/groupby_utils/index.html
@@ -16,7 +16,7 @@
         <link rel="prev" href="../file_reader_utils/">
       
       
-        <link rel="next" href="../groupbys/">
+        <link rel="next" href="../import_utils/">
       
       
       <link rel="icon" href="../../assets/images/favicon.png">
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -749,26 +747,17 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupbyFunction" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;GroupbyFunction
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Limit" class="md-nav__link">
+  <a href="#tablite.groupby_utils.GroupBy" class="md-nav__link">
     <span class="md-ellipsis">
-      &nbsp;Limit
+      &nbsp;GroupBy
     </span>
   </a>
   
-    <nav class="md-nav" aria-label=" Limit">
+    <nav class="md-nav" aria-label=" GroupBy">
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Limit-attributes" class="md-nav__link">
+  <a href="#tablite.groupby_utils.GroupBy-attributes" class="md-nav__link">
     <span class="md-ellipsis">
       Attributes
     </span>
@@ -778,162 +767,108 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Limit.value" class="md-nav__link">
+  <a href="#tablite.groupby_utils.GroupBy.max" class="md-nav__link">
     <span class="md-ellipsis">
-      &nbsp;value
+      &nbsp;max
     </span>
   </a>
   
 </li>
         
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Limit.f" class="md-nav__link">
+  <a href="#tablite.groupby_utils.GroupBy.min" class="md-nav__link">
     <span class="md-ellipsis">
-      &nbsp;f
+      &nbsp;min
     </span>
   </a>
   
 </li>
         
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Limit-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Limit.update" class="md-nav__link">
+  <a href="#tablite.groupby_utils.GroupBy.sum" class="md-nav__link">
     <span class="md-ellipsis">
-      &nbsp;update
+      &nbsp;sum
     </span>
   </a>
   
 </li>
         
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Max" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;Max
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" Max">
-      <ul class="md-nav__list">
-        
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Max-attributes" class="md-nav__link">
+  <a href="#tablite.groupby_utils.GroupBy.product" class="md-nav__link">
     <span class="md-ellipsis">
-      Attributes
+      &nbsp;product
     </span>
   </a>
   
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
+</li>
         
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Max.value" class="md-nav__link">
+  <a href="#tablite.groupby_utils.GroupBy.first" class="md-nav__link">
     <span class="md-ellipsis">
-      &nbsp;value
+      &nbsp;first
     </span>
   </a>
   
 </li>
         
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Max.f" class="md-nav__link">
+  <a href="#tablite.groupby_utils.GroupBy.last" class="md-nav__link">
     <span class="md-ellipsis">
-      &nbsp;f
+      &nbsp;last
     </span>
   </a>
   
-</li>
-        
-      </ul>
-    </nav>
-  
 </li>
         
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Max-functions" class="md-nav__link">
+  <a href="#tablite.groupby_utils.GroupBy.count" class="md-nav__link">
     <span class="md-ellipsis">
-      Functions
+      &nbsp;count
     </span>
   </a>
   
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
+</li>
         
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Max.update" class="md-nav__link">
+  <a href="#tablite.groupby_utils.GroupBy.count_unique" class="md-nav__link">
     <span class="md-ellipsis">
-      &nbsp;update
+      &nbsp;count_unique
     </span>
   </a>
   
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
 </li>
         
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Min" class="md-nav__link">
+  <a href="#tablite.groupby_utils.GroupBy.avg" class="md-nav__link">
     <span class="md-ellipsis">
-      &nbsp;Min
+      &nbsp;avg
     </span>
   </a>
   
-    <nav class="md-nav" aria-label=" Min">
-      <ul class="md-nav__list">
+</li>
         
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Min-attributes" class="md-nav__link">
+  <a href="#tablite.groupby_utils.GroupBy.stdev" class="md-nav__link">
     <span class="md-ellipsis">
-      Attributes
+      &nbsp;stdev
     </span>
   </a>
   
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
+</li>
         
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Min.value" class="md-nav__link">
+  <a href="#tablite.groupby_utils.GroupBy.median" class="md-nav__link">
     <span class="md-ellipsis">
-      &nbsp;value
+      &nbsp;median
     </span>
   </a>
   
 </li>
         
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Min.f" class="md-nav__link">
+  <a href="#tablite.groupby_utils.GroupBy.mode" class="md-nav__link">
     <span class="md-ellipsis">
-      &nbsp;f
+      &nbsp;mode
     </span>
   </a>
   
@@ -944,22 +879,8 @@
   
 </li>
         
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Min-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Min.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
+      </ul>
+    </nav>
   
 </li>
         
@@ -972,496 +893,415 @@
     </nav>
   
 </li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Sum" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;Sum
-    </span>
-  </a>
+      
+    </ul>
   
-    <nav class="md-nav" aria-label=" Sum">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Sum-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
+</nav>
+      
+    </li>
   
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Sum.value" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;value
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Sum-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Sum.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../import_utils/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-        
-      </ul>
-    </nav>
+  <span class="md-ellipsis">
+    Import utils
+  </span>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Product" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;Product
-    </span>
-  </a>
+
+      </a>
+    </li>
   
-    <nav class="md-nav" aria-label=" Product">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Product-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Product.value" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;value
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Product-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
+    <li class="md-nav__item">
+      <a href="../imputation/" class="md-nav__link">
         
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Product.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
+  <span class="md-ellipsis">
+    Imputation
+  </span>
   
-</li>
-        
-      </ul>
-    </nav>
+
+      </a>
+    </li>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.First" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;First
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-    <nav class="md-nav" aria-label=" First">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.First-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.First.empty" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;empty
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.First.value" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;value
-    </span>
-  </a>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../joins/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.First-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    Joins
+  </span>
   
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.First.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
+
+      </a>
+    </li>
   
-</li>
-        
-      </ul>
-    </nav>
+
+              
+            
+              
+                
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Last" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;Last
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label=" Last">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Last-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
+    <li class="md-nav__item">
+      <a href="../lookup/" class="md-nav__link">
         
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Last.value" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;value
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
+  <span class="md-ellipsis">
+    Lookup
+  </span>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Last-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
+
+      </a>
+    </li>
   
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Last.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Count" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;Count
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label=" Count">
-      <ul class="md-nav__list">
+    <li class="md-nav__item">
+      <a href="../match/" class="md-nav__link">
         
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Count-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Count.value" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;value
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    Match
+  </span>
   
-</li>
-        
-      </ul>
-    </nav>
+
+      </a>
+    </li>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Count-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Count.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../merge/" class="md-nav__link">
         
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.CountUnique" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;CountUnique
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label=" CountUnique">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.CountUnique-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
+  <span class="md-ellipsis">
+    Merge
+  </span>
   
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.CountUnique.items" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;items
-    </span>
-  </a>
+
+      </a>
+    </li>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.CountUnique.value" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;value
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-</li>
-        
-      </ul>
-    </nav>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.CountUnique-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
   
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.CountUnique.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../mp_utils/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
-        
-      </ul>
-    </nav>
+  <span class="md-ellipsis">
+    Mp utils
+  </span>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Average" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;Average
-    </span>
-  </a>
+
+      </a>
+    </li>
   
-    <nav class="md-nav" aria-label=" Average">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Average-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
+
+              
+            
+              
+                
   
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Average.sum" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;sum
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Average.count" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;count
-    </span>
-  </a>
   
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Average.value" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;value
-    </span>
-  </a>
   
-</li>
+    <li class="md-nav__item">
+      <a href="../nimlite/" class="md-nav__link">
         
-      </ul>
-    </nav>
   
-</li>
+  <span class="md-ellipsis">
+    Nimlite
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../pivots/" class="md-nav__link">
         
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Average-functions" class="md-nav__link">
+  
+  <span class="md-ellipsis">
+    Pivots
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../redux/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Redux
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../reindex/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Reindex
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../sort_utils/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Sort utils
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../sortation/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Sortation
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../tools/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Tools
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../utils/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Utils
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../version/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Version
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+  </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+            
+              
+              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#tablite.groupby_utils" class="md-nav__link">
     <span class="md-ellipsis">
-      Functions
+      &nbsp;groupby_utils
     </span>
   </a>
   
-    <nav class="md-nav" aria-label="Functions">
+    <nav class="md-nav" aria-label=" groupby_utils">
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Average.update" class="md-nav__link">
+  <a href="#tablite.groupby_utils-classes" class="md-nav__link">
     <span class="md-ellipsis">
-      &nbsp;update
+      Classes
     </span>
   </a>
   
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.StandardDeviation" class="md-nav__link">
+  <a href="#tablite.groupby_utils.GroupBy" class="md-nav__link">
     <span class="md-ellipsis">
-      &nbsp;StandardDeviation
+      &nbsp;GroupBy
     </span>
   </a>
   
-    <nav class="md-nav" aria-label=" StandardDeviation">
+    <nav class="md-nav" aria-label=" GroupBy">
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.StandardDeviation-attributes" class="md-nav__link">
+  <a href="#tablite.groupby_utils.GroupBy-attributes" class="md-nav__link">
     <span class="md-ellipsis">
       Attributes
     </span>
@@ -1471,351 +1311,54 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.StandardDeviation.count" class="md-nav__link">
+  <a href="#tablite.groupby_utils.GroupBy.max" class="md-nav__link">
     <span class="md-ellipsis">
-      &nbsp;count
+      &nbsp;max
     </span>
   </a>
   
 </li>
         
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.StandardDeviation.mean" class="md-nav__link">
+  <a href="#tablite.groupby_utils.GroupBy.min" class="md-nav__link">
     <span class="md-ellipsis">
-      &nbsp;mean
+      &nbsp;min
     </span>
   </a>
   
 </li>
         
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.StandardDeviation.c" class="md-nav__link">
+  <a href="#tablite.groupby_utils.GroupBy.sum" class="md-nav__link">
     <span class="md-ellipsis">
-      &nbsp;c
+      &nbsp;sum
     </span>
   </a>
   
 </li>
         
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.StandardDeviation.value" class="md-nav__link">
+  <a href="#tablite.groupby_utils.GroupBy.product" class="md-nav__link">
     <span class="md-ellipsis">
-      &nbsp;value
+      &nbsp;product
     </span>
   </a>
   
-</li>
-        
-      </ul>
-    </nav>
-  
 </li>
         
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.StandardDeviation-functions" class="md-nav__link">
+  <a href="#tablite.groupby_utils.GroupBy.first" class="md-nav__link">
     <span class="md-ellipsis">
-      Functions
+      &nbsp;first
     </span>
   </a>
   
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
+</li>
         
           <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.StandardDeviation.update" class="md-nav__link">
+  <a href="#tablite.groupby_utils.GroupBy.last" class="md-nav__link">
     <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Histogram" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;Histogram
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" Histogram">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Histogram-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Histogram.hist" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;hist
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Histogram-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Histogram.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Median" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;Median
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" Median">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Median-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Median.hist" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;hist
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Median.value" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;value
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Median-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Median.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Mode" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;Mode
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" Mode">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Mode-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Mode.hist" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;hist
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Mode.value" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;value
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Mode-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Mode.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;GroupBy
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" GroupBy">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.max" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;max
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.min" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;min
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.sum" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;sum
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.product" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;product
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.first" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;first
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.last" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;last
+      &nbsp;last
     </span>
   </a>
   
@@ -1860,3228 +1403,80 @@
           <li class="md-nav__item">
   <a href="#tablite.groupby_utils.GroupBy.median" class="md-nav__link">
     <span class="md-ellipsis">
-      &nbsp;median
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.mode" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;mode
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;functions
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.function_names" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;function_names
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../import_utils/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Import utils
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../imputation/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Imputation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../joins/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Joins
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../lookup/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Lookup
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../match/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Match
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../merge/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Merge
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mp_utils/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Mp utils
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../nimlite/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Nimlite
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../pivots/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Pivots
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../redux/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redux
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reindex/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reindex
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sort_utils/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sort utils
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sortation/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sortation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../tools/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tools
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../utils/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Utils
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../version/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Version
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#tablite.groupby_utils" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;groupby_utils
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" groupby_utils">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils-classes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Classes
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Classes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupbyFunction" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;GroupbyFunction
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Limit" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;Limit
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" Limit">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Limit-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Limit.value" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;value
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Limit.f" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;f
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Limit-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Limit.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Max" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;Max
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" Max">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Max-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Max.value" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;value
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Max.f" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;f
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Max-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Max.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Min" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;Min
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" Min">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Min-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Min.value" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;value
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Min.f" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;f
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Min-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Min.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Sum" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;Sum
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" Sum">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Sum-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Sum.value" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;value
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Sum-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Sum.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Product" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;Product
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" Product">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Product-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Product.value" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;value
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Product-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Product.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.First" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;First
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" First">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.First-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.First.empty" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;empty
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.First.value" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;value
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.First-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.First.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Last" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;Last
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" Last">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Last-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Last.value" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;value
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Last-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Last.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Count" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;Count
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" Count">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Count-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Count.value" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;value
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Count-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Count.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.CountUnique" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;CountUnique
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" CountUnique">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.CountUnique-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.CountUnique.items" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;items
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.CountUnique.value" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;value
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.CountUnique-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.CountUnique.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Average" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;Average
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" Average">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Average-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Average.sum" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;sum
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Average.count" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;count
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Average.value" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;value
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Average-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Average.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.StandardDeviation" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;StandardDeviation
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" StandardDeviation">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.StandardDeviation-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.StandardDeviation.count" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;count
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.StandardDeviation.mean" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;mean
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.StandardDeviation.c" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;c
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.StandardDeviation.value" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;value
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.StandardDeviation-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.StandardDeviation.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Histogram" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;Histogram
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" Histogram">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Histogram-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Histogram.hist" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;hist
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Histogram-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Histogram.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Median" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;Median
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" Median">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Median-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Median.hist" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;hist
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Median.value" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;value
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Median-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Median.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Mode" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;Mode
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" Mode">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Mode-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Mode.hist" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;hist
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Mode.value" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;value
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Mode-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.Mode.update" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;update
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;GroupBy
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" GroupBy">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy-attributes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Attributes
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Attributes">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.max" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;max
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.min" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;min
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.sum" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;sum
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.product" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;product
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.first" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;first
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.last" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;last
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.count" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;count
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.count_unique" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;count_unique
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.avg" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;avg
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.stdev" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;stdev
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.median" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;median
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.mode" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;mode
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;functions
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupby_utils.GroupBy.function_names" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;function_names
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-
-  <h1>Groupby utils</h1>
-
-<div class="doc doc-object doc-module">
-
-
-
-<h2 id="tablite.groupby_utils" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>          <code>tablite.groupby_utils</code>
-
-
-</h2>
-
-  <div class="doc doc-contents first">
-
-  
-
-  <div class="doc doc-children">
-
-
-
-
-
-
-<h3 id="tablite.groupby_utils-classes">Classes</h3>
-
-<div class="doc doc-object doc-class">
-
-
-
-<h4 id="tablite.groupby_utils.GroupbyFunction" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>          <code>tablite.groupby_utils.GroupbyFunction</code>
-
-
-</h4>
-
-
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code>object</code></p>
-
-
-
-  </div>
-
-
-</div>
-
-<div class="doc doc-object doc-class">
-
-
-
-<h4 id="tablite.groupby_utils.Limit" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Limit</span><span class="p">()</span></code>
-
-</h4>
-
-
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="tablite.groupby_utils.GroupbyFunction" href="#tablite.groupby_utils.GroupbyFunction">GroupbyFunction</a></code></p>
-
-
-                <details class="quote">
-                  <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-                  <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">10</span>
-<span class="normal">11</span>
-<span class="normal">12</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="kc">None</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">f</span> <span class="o">=</span> <span class="kc">None</span>
-</code></pre></div></td></tr></table></div>
-                </details>
-
-  
-
-  <div class="doc doc-children">
-
-
-
-
-
-<h5 id="tablite.groupby_utils.Limit-attributes">Attributes</h5>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.Limit.value" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Limit</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="kc">None</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.Limit.f" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Limit</span><span class="o">.</span><span class="n">f</span> <span class="o">=</span> <span class="kc">None</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<h5 id="tablite.groupby_utils.Limit-functions">Functions</h5>
-
-
-<div class="doc doc-object doc-function">
-
-
-
-<h6 id="tablite.groupby_utils.Limit.update" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Limit</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">value</span><span class="p">)</span></code>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-
-          <details class="quote">
-            <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">14</span>
-<span class="normal">15</span>
-<span class="normal">16</span>
-<span class="normal">17</span>
-<span class="normal">18</span>
-<span class="normal">19</span>
-<span class="normal">20</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-    <span class="k">if</span> <span class="n">value</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="k">pass</span>
-    <span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="n">value</span>
-    <span class="k">else</span><span class="p">:</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">f</span><span class="p">((</span><span class="n">value</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">value</span><span class="p">))</span>
-</code></pre></div></td></tr></table></div>
-          </details>
-  </div>
-
-</div>
-
-
-
-  </div>
-
-  </div>
-
-
-</div>
-
-<div class="doc doc-object doc-class">
-
-
-
-<h4 id="tablite.groupby_utils.Max" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Max</span><span class="p">()</span></code>
-
-</h4>
-
-
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="tablite.groupby_utils.Limit" href="#tablite.groupby_utils.Limit">Limit</a></code></p>
-
-
-                <details class="quote">
-                  <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-                  <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">24</span>
-<span class="normal">25</span>
-<span class="normal">26</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-    <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">()</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">f</span> <span class="o">=</span> <span class="nb">max</span>
-</code></pre></div></td></tr></table></div>
-                </details>
-
-  
-
-  <div class="doc doc-children">
-
-
-
-
-
-<h5 id="tablite.groupby_utils.Max-attributes">Attributes</h5>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.Max.value" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Max</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="kc">None</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.Max.f" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Max</span><span class="o">.</span><span class="n">f</span> <span class="o">=</span> <span class="nb">max</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<h5 id="tablite.groupby_utils.Max-functions">Functions</h5>
-
-
-<div class="doc doc-object doc-function">
-
-
-
-<h6 id="tablite.groupby_utils.Max.update" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Max</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">value</span><span class="p">)</span></code>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-
-          <details class="quote">
-            <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">14</span>
-<span class="normal">15</span>
-<span class="normal">16</span>
-<span class="normal">17</span>
-<span class="normal">18</span>
-<span class="normal">19</span>
-<span class="normal">20</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-    <span class="k">if</span> <span class="n">value</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="k">pass</span>
-    <span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="n">value</span>
-    <span class="k">else</span><span class="p">:</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">f</span><span class="p">((</span><span class="n">value</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">value</span><span class="p">))</span>
-</code></pre></div></td></tr></table></div>
-          </details>
-  </div>
-
-</div>
-
-
-
-  </div>
-
-  </div>
-
-
-</div>
-
-<div class="doc doc-object doc-class">
-
-
-
-<h4 id="tablite.groupby_utils.Min" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Min</span><span class="p">()</span></code>
-
-</h4>
-
-
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="tablite.groupby_utils.Limit" href="#tablite.groupby_utils.Limit">Limit</a></code></p>
-
-
-                <details class="quote">
-                  <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-                  <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">30</span>
-<span class="normal">31</span>
-<span class="normal">32</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-    <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">()</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">f</span> <span class="o">=</span> <span class="nb">min</span>
-</code></pre></div></td></tr></table></div>
-                </details>
-
-  
-
-  <div class="doc doc-children">
-
-
-
-
-
-<h5 id="tablite.groupby_utils.Min-attributes">Attributes</h5>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.Min.value" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Min</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="kc">None</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.Min.f" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Min</span><span class="o">.</span><span class="n">f</span> <span class="o">=</span> <span class="nb">min</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<h5 id="tablite.groupby_utils.Min-functions">Functions</h5>
-
-
-<div class="doc doc-object doc-function">
-
-
-
-<h6 id="tablite.groupby_utils.Min.update" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Min</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">value</span><span class="p">)</span></code>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-
-          <details class="quote">
-            <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">14</span>
-<span class="normal">15</span>
-<span class="normal">16</span>
-<span class="normal">17</span>
-<span class="normal">18</span>
-<span class="normal">19</span>
-<span class="normal">20</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-    <span class="k">if</span> <span class="n">value</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="k">pass</span>
-    <span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="n">value</span>
-    <span class="k">else</span><span class="p">:</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">f</span><span class="p">((</span><span class="n">value</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">value</span><span class="p">))</span>
-</code></pre></div></td></tr></table></div>
-          </details>
-  </div>
-
-</div>
-
-
-
-  </div>
-
-  </div>
-
-
-</div>
-
-<div class="doc doc-object doc-class">
-
-
-
-<h4 id="tablite.groupby_utils.Sum" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Sum</span><span class="p">()</span></code>
-
-</h4>
-
-
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="tablite.groupby_utils.GroupbyFunction" href="#tablite.groupby_utils.GroupbyFunction">GroupbyFunction</a></code></p>
-
-
-                <details class="quote">
-                  <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-                  <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">36</span>
-<span class="normal">37</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="mi">0</span>
-</code></pre></div></td></tr></table></div>
-                </details>
-
-  
-
-  <div class="doc doc-children">
-
-
-
-
-
-<h5 id="tablite.groupby_utils.Sum-attributes">Attributes</h5>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.Sum.value" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Sum</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="mi">0</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<h5 id="tablite.groupby_utils.Sum-functions">Functions</h5>
-
-
-<div class="doc doc-object doc-function">
-
-
-
-<h6 id="tablite.groupby_utils.Sum.update" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Sum</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">value</span><span class="p">)</span></code>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-
-          <details class="quote">
-            <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">39</span>
-<span class="normal">40</span>
-<span class="normal">41</span>
-<span class="normal">42</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="p">(</span><span class="nb">type</span><span class="p">(</span><span class="kc">None</span><span class="p">),</span> <span class="n">date</span><span class="p">,</span> <span class="n">time</span><span class="p">,</span> <span class="n">datetime</span><span class="p">,</span> <span class="nb">str</span><span class="p">)):</span>
-        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Sum of </span><span class="si">{</span><span class="nb">type</span><span class="p">(</span><span class="n">value</span><span class="p">)</span><span class="si">}</span><span class="s2"> doesn&#39;t make sense.&quot;</span><span class="p">)</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="o">+=</span> <span class="n">value</span>
-</code></pre></div></td></tr></table></div>
-          </details>
-  </div>
-
-</div>
-
-
-
-  </div>
-
-  </div>
-
-
-</div>
-
-<div class="doc doc-object doc-class">
-
-
-
-<h4 id="tablite.groupby_utils.Product" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Product</span><span class="p">()</span></code>
-
-</h4>
-
-
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="tablite.groupby_utils.GroupbyFunction" href="#tablite.groupby_utils.GroupbyFunction">GroupbyFunction</a></code></p>
-
-
-                <details class="quote">
-                  <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-                  <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">46</span>
-<span class="normal">47</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="mi">1</span>
-</code></pre></div></td></tr></table></div>
-                </details>
-
-  
-
-  <div class="doc doc-children">
-
-
-
-
-
-<h5 id="tablite.groupby_utils.Product-attributes">Attributes</h5>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.Product.value" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Product</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="mi">1</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<h5 id="tablite.groupby_utils.Product-functions">Functions</h5>
-
-
-<div class="doc doc-object doc-function">
-
-
-
-<h6 id="tablite.groupby_utils.Product.update" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Product</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">value</span><span class="p">)</span></code>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-
-          <details class="quote">
-            <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">49</span>
-<span class="normal">50</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="o">*=</span> <span class="n">value</span>
-</code></pre></div></td></tr></table></div>
-          </details>
-  </div>
-
-</div>
-
-
-
-  </div>
-
-  </div>
-
-
-</div>
-
-<div class="doc doc-object doc-class">
-
-
-
-<h4 id="tablite.groupby_utils.First" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">First</span><span class="p">()</span></code>
-
-</h4>
-
-
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="tablite.groupby_utils.GroupbyFunction" href="#tablite.groupby_utils.GroupbyFunction">GroupbyFunction</a></code></p>
-
-
-                <details class="quote">
-                  <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-                  <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">59</span>
-<span class="normal">60</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">empty</span>
-</code></pre></div></td></tr></table></div>
-                </details>
-
-  
-
-  <div class="doc doc-children">
-
-
-
-
-
-<h5 id="tablite.groupby_utils.First-attributes">Attributes</h5>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.First.empty" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">First</span><span class="o">.</span><span class="n">empty</span> <span class="o">=</span> <span class="p">(</span><span class="kc">None</span><span class="p">)</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small>
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.First.value" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">First</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">empty</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<h5 id="tablite.groupby_utils.First-functions">Functions</h5>
-
-
-<div class="doc doc-object doc-function">
-
-
-
-<h6 id="tablite.groupby_utils.First.update" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">First</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">value</span><span class="p">)</span></code>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-
-          <details class="quote">
-            <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">62</span>
-<span class="normal">63</span>
-<span class="normal">64</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-    <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="ow">is</span> <span class="n">First</span><span class="o">.</span><span class="n">empty</span><span class="p">:</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="n">value</span>
-</code></pre></div></td></tr></table></div>
-          </details>
-  </div>
-
-</div>
-
-
-
-  </div>
-
-  </div>
-
-
-</div>
-
-<div class="doc doc-object doc-class">
-
-
-
-<h4 id="tablite.groupby_utils.Last" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Last</span><span class="p">()</span></code>
-
-</h4>
-
-
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="tablite.groupby_utils.GroupbyFunction" href="#tablite.groupby_utils.GroupbyFunction">GroupbyFunction</a></code></p>
-
-
-                <details class="quote">
-                  <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-                  <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">68</span>
-<span class="normal">69</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="kc">None</span>
-</code></pre></div></td></tr></table></div>
-                </details>
-
-  
-
-  <div class="doc doc-children">
-
-
-
-
-
-<h5 id="tablite.groupby_utils.Last-attributes">Attributes</h5>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.Last.value" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Last</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="kc">None</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<h5 id="tablite.groupby_utils.Last-functions">Functions</h5>
-
-
-<div class="doc doc-object doc-function">
-
-
-
-<h6 id="tablite.groupby_utils.Last.update" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Last</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">value</span><span class="p">)</span></code>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-
-          <details class="quote">
-            <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">71</span>
-<span class="normal">72</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="n">value</span>
-</code></pre></div></td></tr></table></div>
-          </details>
-  </div>
-
-</div>
-
-
-
-  </div>
-
-  </div>
-
-
-</div>
-
-<div class="doc doc-object doc-class">
-
-
-
-<h4 id="tablite.groupby_utils.Count" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Count</span><span class="p">()</span></code>
-
-</h4>
-
-
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="tablite.groupby_utils.GroupbyFunction" href="#tablite.groupby_utils.GroupbyFunction">GroupbyFunction</a></code></p>
-
-
-                <details class="quote">
-                  <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-                  <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">76</span>
-<span class="normal">77</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="mi">0</span>
-</code></pre></div></td></tr></table></div>
-                </details>
-
-  
-
-  <div class="doc doc-children">
-
-
-
-
-
-<h5 id="tablite.groupby_utils.Count-attributes">Attributes</h5>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.Count.value" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Count</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="mi">0</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<h5 id="tablite.groupby_utils.Count-functions">Functions</h5>
-
-
-<div class="doc doc-object doc-function">
-
-
-
-<h6 id="tablite.groupby_utils.Count.update" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Count</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">value</span><span class="p">)</span></code>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-
-          <details class="quote">
-            <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">79</span>
-<span class="normal">80</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="o">+=</span> <span class="mi">1</span>
-</code></pre></div></td></tr></table></div>
-          </details>
-  </div>
-
-</div>
-
-
-
-  </div>
-
-  </div>
-
-
-</div>
-
-<div class="doc doc-object doc-class">
-
-
-
-<h4 id="tablite.groupby_utils.CountUnique" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">CountUnique</span><span class="p">()</span></code>
-
-</h4>
-
-
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="tablite.groupby_utils.GroupbyFunction" href="#tablite.groupby_utils.GroupbyFunction">GroupbyFunction</a></code></p>
-
-
-                <details class="quote">
-                  <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-                  <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">84</span>
-<span class="normal">85</span>
-<span class="normal">86</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">items</span> <span class="o">=</span> <span class="nb">set</span><span class="p">()</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="kc">None</span>
-</code></pre></div></td></tr></table></div>
-                </details>
-
-  
-
-  <div class="doc doc-children">
-
-
-
-
-
-<h5 id="tablite.groupby_utils.CountUnique-attributes">Attributes</h5>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.CountUnique.items" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">CountUnique</span><span class="o">.</span><span class="n">items</span> <span class="o">=</span> <span class="nb">set</span><span class="p">()</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.CountUnique.value" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">CountUnique</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="kc">None</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<h5 id="tablite.groupby_utils.CountUnique-functions">Functions</h5>
-
-
-<div class="doc doc-object doc-function">
-
-
-
-<h6 id="tablite.groupby_utils.CountUnique.update" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">CountUnique</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">value</span><span class="p">)</span></code>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-
-          <details class="quote">
-            <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">88</span>
-<span class="normal">89</span>
-<span class="normal">90</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">items</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">items</span><span class="p">)</span>
-</code></pre></div></td></tr></table></div>
-          </details>
-  </div>
-
-</div>
-
-
-
-  </div>
-
-  </div>
-
-
-</div>
-
-<div class="doc doc-object doc-class">
-
-
-
-<h4 id="tablite.groupby_utils.Average" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Average</span><span class="p">()</span></code>
-
-</h4>
-
-
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="tablite.groupby_utils.GroupbyFunction" href="#tablite.groupby_utils.GroupbyFunction">GroupbyFunction</a></code></p>
-
-
-                <details class="quote">
-                  <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-                  <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">94</span>
-<span class="normal">95</span>
-<span class="normal">96</span>
-<span class="normal">97</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">sum</span> <span class="o">=</span> <span class="mi">0</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">count</span> <span class="o">=</span> <span class="mi">0</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="mi">0</span>
-</code></pre></div></td></tr></table></div>
-                </details>
-
-  
-
-  <div class="doc doc-children">
-
-
-
-
-
-<h5 id="tablite.groupby_utils.Average-attributes">Attributes</h5>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.Average.sum" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Average</span><span class="o">.</span><span class="n">sum</span> <span class="o">=</span> <span class="mi">0</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.Average.count" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Average</span><span class="o">.</span><span class="n">count</span> <span class="o">=</span> <span class="mi">0</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.Average.value" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Average</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="mi">0</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<h5 id="tablite.groupby_utils.Average-functions">Functions</h5>
-
-
-<div class="doc doc-object doc-function">
-
-
-
-<h6 id="tablite.groupby_utils.Average.update" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Average</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">value</span><span class="p">)</span></code>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-
-          <details class="quote">
-            <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 99</span>
-<span class="normal">100</span>
-<span class="normal">101</span>
-<span class="normal">102</span>
-<span class="normal">103</span>
-<span class="normal">104</span>
-<span class="normal">105</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="p">(</span><span class="n">date</span><span class="p">,</span> <span class="n">time</span><span class="p">,</span> <span class="n">datetime</span><span class="p">,</span> <span class="nb">str</span><span class="p">)):</span>
-        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Sum of </span><span class="si">{</span><span class="nb">type</span><span class="p">(</span><span class="n">value</span><span class="p">)</span><span class="si">}</span><span class="s2"> doesn&#39;t make sense.&quot;</span><span class="p">)</span>
-    <span class="k">if</span> <span class="n">value</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">sum</span> <span class="o">+=</span> <span class="n">value</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">count</span> <span class="o">+=</span> <span class="mi">1</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">sum</span> <span class="o">/</span> <span class="bp">self</span><span class="o">.</span><span class="n">count</span>
-</code></pre></div></td></tr></table></div>
-          </details>
-  </div>
-
-</div>
-
-
-
-  </div>
-
-  </div>
-
-
-</div>
-
-<div class="doc doc-object doc-class">
-
-
-
-<h4 id="tablite.groupby_utils.StandardDeviation" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">StandardDeviation</span><span class="p">()</span></code>
-
-</h4>
-
-
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="tablite.groupby_utils.GroupbyFunction" href="#tablite.groupby_utils.GroupbyFunction">GroupbyFunction</a></code></p>
-
-  
-      <p>Uses J.P. Welfords (1962) algorithm.
-For details see https://en.wikipedia.org/wiki/Algorithms_for_calculating_variance#Online_algorithm</p>
-
-                <details class="quote">
-                  <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-                  <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">114</span>
-<span class="normal">115</span>
-<span class="normal">116</span>
-<span class="normal">117</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">count</span> <span class="o">=</span> <span class="mi">0</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">mean</span> <span class="o">=</span> <span class="mi">0</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">c</span> <span class="o">=</span> <span class="mf">0.0</span>
-</code></pre></div></td></tr></table></div>
-                </details>
-
-  
-
-  <div class="doc doc-children">
-
-
-
-
-
-<h5 id="tablite.groupby_utils.StandardDeviation-attributes">Attributes</h5>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.StandardDeviation.count" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">StandardDeviation</span><span class="o">.</span><span class="n">count</span> <span class="o">=</span> <span class="mi">0</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.StandardDeviation.mean" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">StandardDeviation</span><span class="o">.</span><span class="n">mean</span> <span class="o">=</span> <span class="mi">0</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.StandardDeviation.c" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">StandardDeviation</span><span class="o">.</span><span class="n">c</span> <span class="o">=</span> <span class="mf">0.0</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.StandardDeviation.value" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">StandardDeviation</span><span class="o">.</span><span class="n">value</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-property"><code>property</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<h5 id="tablite.groupby_utils.StandardDeviation-functions">Functions</h5>
-
-
-<div class="doc doc-object doc-function">
-
-
-
-<h6 id="tablite.groupby_utils.StandardDeviation.update" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">StandardDeviation</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">value</span><span class="p">)</span></code>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-
-          <details class="quote">
-            <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">119</span>
-<span class="normal">120</span>
-<span class="normal">121</span>
-<span class="normal">122</span>
-<span class="normal">123</span>
-<span class="normal">124</span>
-<span class="normal">125</span>
-<span class="normal">126</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="p">(</span><span class="n">date</span><span class="p">,</span> <span class="n">time</span><span class="p">,</span> <span class="n">datetime</span><span class="p">,</span> <span class="nb">str</span><span class="p">)):</span>
-        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Std.dev. of </span><span class="si">{</span><span class="nb">type</span><span class="p">(</span><span class="n">value</span><span class="p">)</span><span class="si">}</span><span class="s2"> doesn&#39;t make sense.&quot;</span><span class="p">)</span>
-    <span class="k">if</span> <span class="n">value</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">count</span> <span class="o">+=</span> <span class="mi">1</span>
-        <span class="n">dt</span> <span class="o">=</span> <span class="n">value</span> <span class="o">-</span> <span class="bp">self</span><span class="o">.</span><span class="n">mean</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">mean</span> <span class="o">+=</span> <span class="n">dt</span> <span class="o">/</span> <span class="bp">self</span><span class="o">.</span><span class="n">count</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">c</span> <span class="o">+=</span> <span class="n">dt</span> <span class="o">*</span> <span class="p">(</span><span class="n">value</span> <span class="o">-</span> <span class="bp">self</span><span class="o">.</span><span class="n">mean</span><span class="p">)</span>
-</code></pre></div></td></tr></table></div>
-          </details>
-  </div>
-
-</div>
-
-
-
-  </div>
-
-  </div>
-
-
-</div>
-
-<div class="doc doc-object doc-class">
-
-
-
-<h4 id="tablite.groupby_utils.Histogram" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Histogram</span><span class="p">()</span></code>
-
-</h4>
-
-
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="tablite.groupby_utils.GroupbyFunction" href="#tablite.groupby_utils.GroupbyFunction">GroupbyFunction</a></code></p>
-
-
-                <details class="quote">
-                  <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-                  <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">137</span>
-<span class="normal">138</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">hist</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="nb">int</span><span class="p">)</span>
-</code></pre></div></td></tr></table></div>
-                </details>
-
-  
-
-  <div class="doc doc-children">
-
-
-
-
-
-<h5 id="tablite.groupby_utils.Histogram-attributes">Attributes</h5>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.Histogram.hist" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Histogram</span><span class="o">.</span><span class="n">hist</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="nb">int</span><span class="p">)</span></code>
+      &nbsp;median
+    </span>
+  </a>
   
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<h5 id="tablite.groupby_utils.Histogram-functions">Functions</h5>
-
-
-<div class="doc doc-object doc-function">
-
-
-
-<h6 id="tablite.groupby_utils.Histogram.update" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Histogram</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">value</span><span class="p">)</span></code>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-
-          <details class="quote">
-            <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">140</span>
-<span class="normal">141</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">hist</span><span class="p">[</span><span class="n">value</span><span class="p">]</span> <span class="o">+=</span> <span class="mi">1</span>
-</code></pre></div></td></tr></table></div>
-          </details>
-  </div>
-
-</div>
-
-
-
-  </div>
-
-  </div>
-
-
-</div>
-
-<div class="doc doc-object doc-class">
-
-
-
-<h4 id="tablite.groupby_utils.Median" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Median</span><span class="p">()</span></code>
-
-</h4>
-
-
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="tablite.groupby_utils.Histogram" href="#tablite.groupby_utils.Histogram">Histogram</a></code></p>
-
-
-                <details class="quote">
-                  <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-                  <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">145</span>
-<span class="normal">146</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-    <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">()</span>
-</code></pre></div></td></tr></table></div>
-                </details>
-
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#tablite.groupby_utils.GroupBy.mode" class="md-nav__link">
+    <span class="md-ellipsis">
+      &nbsp;mode
+    </span>
+  </a>
   
-
-  <div class="doc doc-children">
-
-
-
-
-
-<h5 id="tablite.groupby_utils.Median-attributes">Attributes</h5>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.Median.hist" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Median</span><span class="o">.</span><span class="n">hist</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="nb">int</span><span class="p">)</span></code>
+</li>
+        
+      </ul>
+    </nav>
   
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.Median.value" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Median</span><span class="o">.</span><span class="n">value</span></code>
+</li>
+        
+      </ul>
+    </nav>
   
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-property"><code>property</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<h5 id="tablite.groupby_utils.Median-functions">Functions</h5>
-
-
-<div class="doc doc-object doc-function">
-
-
-
-<h6 id="tablite.groupby_utils.Median.update" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Median</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">value</span><span class="p">)</span></code>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-
-          <details class="quote">
-            <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">140</span>
-<span class="normal">141</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">hist</span><span class="p">[</span><span class="n">value</span><span class="p">]</span> <span class="o">+=</span> <span class="mi">1</span>
-</code></pre></div></td></tr></table></div>
-          </details>
-  </div>
-
-</div>
-
-
-
-  </div>
-
-  </div>
-
-
-</div>
-
-<div class="doc doc-object doc-class">
-
-
-
-<h4 id="tablite.groupby_utils.Mode" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Mode</span><span class="p">()</span></code>
-
-</h4>
-
-
-  <div class="doc doc-contents ">
-          <p class="doc doc-class-bases">
-            Bases: <code><a class="autorefs autorefs-internal" title="tablite.groupby_utils.Histogram" href="#tablite.groupby_utils.Histogram">Histogram</a></code></p>
-
-
-                <details class="quote">
-                  <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-                  <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">174</span>
-<span class="normal">175</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-    <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">()</span>
-</code></pre></div></td></tr></table></div>
-                </details>
-
+</li>
+        
+      </ul>
+    </nav>
   
-
-  <div class="doc doc-children">
-
-
-
-
-
-<h5 id="tablite.groupby_utils.Mode-attributes">Attributes</h5>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.Mode.hist" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Mode</span><span class="o">.</span><span class="n">hist</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="nb">int</span><span class="p">)</span></code>
+</li>
+        
+      </ul>
+    </nav>
   
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.Mode.value" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Mode</span><span class="o">.</span><span class="n">value</span></code>
+</li>
+      
+    </ul>
   
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-property"><code>property</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+          
+          
+            <div class="md-content" data-md-component="content">
+              <article class="md-content__inner md-typeset">
+                
+                  
 
-<h5 id="tablite.groupby_utils.Mode-functions">Functions</h5>
 
+  <h1>Groupby utils</h1>
 
-<div class="doc doc-object doc-function">
+<div class="doc doc-object doc-module">
 
 
 
-<h6 id="tablite.groupby_utils.Mode.update" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">Mode</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">value</span><span class="p">)</span></code>
+<h2 id="tablite.groupby_utils" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>          <code>tablite.groupby_utils</code>
 
-</h6>
 
+</h2>
 
-  <div class="doc doc-contents ">
+  <div class="doc doc-contents first">
 
-          <details class="quote">
-            <summary>Source code in <code>tablite/groupby_utils.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">140</span>
-<span class="normal">141</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-    <span class="bp">self</span><span class="o">.</span><span class="n">hist</span><span class="p">[</span><span class="n">value</span><span class="p">]</span> <span class="o">+=</span> <span class="mi">1</span>
-</code></pre></div></td></tr></table></div>
-          </details>
-  </div>
+  
 
-</div>
+  <div class="doc doc-children">
 
 
 
-  </div>
 
-  </div>
 
 
-</div>
+<h3 id="tablite.groupby_utils-classes">Classes</h3>
 
 <div class="doc doc-object doc-class">
 
@@ -5115,7 +1510,7 @@ <h5 id="tablite.groupby_utils.GroupBy-attributes">Attributes</h5>
 
 
 <h6 id="tablite.groupby_utils.GroupBy.max" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">max</span> <span class="o">=</span> <span class="n">Max</span></code>
+<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">max</span> <span class="o">=</span> <span class="s1">&#39;max&#39;</span></code>
   
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small>
@@ -5135,7 +1530,7 @@ <h6 id="tablite.groupby_utils.GroupBy.max" class="doc doc-heading">
 
 
 <h6 id="tablite.groupby_utils.GroupBy.min" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">min</span> <span class="o">=</span> <span class="n">Min</span></code>
+<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">min</span> <span class="o">=</span> <span class="s1">&#39;min&#39;</span></code>
   
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small>
@@ -5155,7 +1550,7 @@ <h6 id="tablite.groupby_utils.GroupBy.min" class="doc doc-heading">
 
 
 <h6 id="tablite.groupby_utils.GroupBy.sum" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">sum</span> <span class="o">=</span> <span class="n">Sum</span></code>
+<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">sum</span> <span class="o">=</span> <span class="s1">&#39;sum&#39;</span></code>
   
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small>
@@ -5175,7 +1570,7 @@ <h6 id="tablite.groupby_utils.GroupBy.sum" class="doc doc-heading">
 
 
 <h6 id="tablite.groupby_utils.GroupBy.product" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">product</span> <span class="o">=</span> <span class="n">Product</span></code>
+<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">product</span> <span class="o">=</span> <span class="s1">&#39;product&#39;</span></code>
   
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small>
@@ -5195,7 +1590,7 @@ <h6 id="tablite.groupby_utils.GroupBy.product" class="doc doc-heading">
 
 
 <h6 id="tablite.groupby_utils.GroupBy.first" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">first</span> <span class="o">=</span> <span class="n">First</span></code>
+<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">first</span> <span class="o">=</span> <span class="s1">&#39;first&#39;</span></code>
   
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small>
@@ -5215,7 +1610,7 @@ <h6 id="tablite.groupby_utils.GroupBy.first" class="doc doc-heading">
 
 
 <h6 id="tablite.groupby_utils.GroupBy.last" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">last</span> <span class="o">=</span> <span class="n">Last</span></code>
+<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">last</span> <span class="o">=</span> <span class="s1">&#39;last&#39;</span></code>
   
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small>
@@ -5235,7 +1630,7 @@ <h6 id="tablite.groupby_utils.GroupBy.last" class="doc doc-heading">
 
 
 <h6 id="tablite.groupby_utils.GroupBy.count" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">count</span> <span class="o">=</span> <span class="n">Count</span></code>
+<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">count</span> <span class="o">=</span> <span class="s1">&#39;count&#39;</span></code>
   
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small>
@@ -5255,7 +1650,7 @@ <h6 id="tablite.groupby_utils.GroupBy.count" class="doc doc-heading">
 
 
 <h6 id="tablite.groupby_utils.GroupBy.count_unique" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">count_unique</span> <span class="o">=</span> <span class="n">CountUnique</span></code>
+<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">count_unique</span> <span class="o">=</span> <span class="s1">&#39;count_unique&#39;</span></code>
   
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small>
@@ -5275,7 +1670,7 @@ <h6 id="tablite.groupby_utils.GroupBy.count_unique" class="doc doc-heading">
 
 
 <h6 id="tablite.groupby_utils.GroupBy.avg" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">avg</span> <span class="o">=</span> <span class="n">Average</span></code>
+<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">avg</span> <span class="o">=</span> <span class="s1">&#39;avg&#39;</span></code>
   
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small>
@@ -5295,7 +1690,7 @@ <h6 id="tablite.groupby_utils.GroupBy.avg" class="doc doc-heading">
 
 
 <h6 id="tablite.groupby_utils.GroupBy.stdev" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">stdev</span> <span class="o">=</span> <span class="n">StandardDeviation</span></code>
+<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">stdev</span> <span class="o">=</span> <span class="s1">&#39;stdev&#39;</span></code>
   
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small>
@@ -5315,7 +1710,7 @@ <h6 id="tablite.groupby_utils.GroupBy.stdev" class="doc doc-heading">
 
 
 <h6 id="tablite.groupby_utils.GroupBy.median" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">median</span> <span class="o">=</span> <span class="n">Median</span></code>
+<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">median</span> <span class="o">=</span> <span class="s1">&#39;median&#39;</span></code>
   
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small>
@@ -5335,47 +1730,7 @@ <h6 id="tablite.groupby_utils.GroupBy.median" class="doc doc-heading">
 
 
 <h6 id="tablite.groupby_utils.GroupBy.mode" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">mode</span> <span class="o">=</span> <span class="n">Mode</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small>
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.GroupBy.functions" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">functions</span> <span class="o">=</span> <span class="p">[</span><span class="n">Max</span><span class="p">,</span> <span class="n">Min</span><span class="p">,</span> <span class="n">Sum</span><span class="p">,</span> <span class="n">First</span><span class="p">,</span> <span class="n">Last</span><span class="p">,</span> <span class="n">Product</span><span class="p">,</span> <span class="n">Count</span><span class="p">,</span> <span class="n">CountUnique</span><span class="p">,</span> <span class="n">Average</span><span class="p">,</span> <span class="n">StandardDeviation</span><span class="p">,</span> <span class="n">Median</span><span class="p">,</span> <span class="n">Mode</span><span class="p">]</span></code>
-  
-  <span class="doc doc-labels">
-      <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small>
-      <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small>
-  </span>
-
-</h6>
-
-
-  <div class="doc doc-contents ">
-  </div>
-
-</div>
-
-<div class="doc doc-object doc-attribute">
-
-
-
-<h6 id="tablite.groupby_utils.GroupBy.function_names" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">function_names</span> <span class="o">=</span> <span class="p">{</span><span class="n">f</span><span class="o">.</span><span class="vm">__name__</span><span class="p">:</span> <span class="n">ffor</span> <span class="n">f</span> <span class="ow">in</span> <span class="n">functions</span><span class="p">}</span></code>
+<code class="doc-symbol doc-symbol-heading doc-symbol-attribute"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupby_utils</span><span class="o">.</span><span class="n">GroupBy</span><span class="o">.</span><span class="n">mode</span> <span class="o">=</span> <span class="s1">&#39;mode&#39;</span></code>
   
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small>
diff --git a/master/reference/groupbys/groupbys.md b/master/reference/groupbys/groupbys.md
deleted file mode 100644
index 904ba04a..00000000
--- a/master/reference/groupbys/groupbys.md
+++ /dev/null
@@ -1 +0,0 @@
-::: tablite.groupbys
diff --git a/master/reference/groupbys/index.html b/master/reference/groupbys/index.html
deleted file mode 100644
index dd291720..00000000
--- a/master/reference/groupbys/index.html
+++ /dev/null
@@ -1,1798 +0,0 @@
-
-<!doctype html>
-<html lang="en" class="no-js">
-  <head>
-    
-      <meta charset="utf-8">
-      <meta name="viewport" content="width=device-width,initial-scale=1">
-      
-        <meta name="description" content="Tablite Documentation">
-      
-      
-      
-        <link rel="canonical" href="https://root-11.github.io/tablite/master/reference/groupbys/">
-      
-      
-        <link rel="prev" href="../groupby_utils/">
-      
-      
-        <link rel="next" href="../import_utils/">
-      
-      
-      <link rel="icon" href="../../assets/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.17">
-    
-    
-      
-        <title>Groupbys - Tablite</title>
-      
-    
-    
-      <link rel="stylesheet" href="../../assets/stylesheets/main.bcfcd587.min.css">
-      
-        
-        <link rel="stylesheet" href="../../assets/stylesheets/palette.06af60db.min.css">
-      
-      
-
-
-    
-    
-      
-    
-    
-      
-        
-        
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
-        <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
-      
-    
-    
-      <link rel="stylesheet" href="../../assets/_mkdocstrings.css">
-    
-      <link rel="stylesheet" href="../../extra.css">
-    
-    <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
-    
-      
-
-    
-    
-    
-  </head>
-  
-  
-    
-    
-    
-    
-    
-    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-purple" data-md-color-accent="deep-purple">
-  
-    
-    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
-    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
-    <label class="md-overlay" for="__drawer"></label>
-    <div data-md-component="skip">
-      
-        
-        <a href="#tablite.groupbys" class="md-skip">
-          Skip to content
-        </a>
-      
-    </div>
-    <div data-md-component="announce">
-      
-    </div>
-    
-      <div data-md-color-scheme="default" data-md-component="outdated" hidden>
-        
-      </div>
-    
-    
-      
-
-  
-
-<header class="md-header md-header--shadow md-header--lifted" data-md-component="header">
-  <nav class="md-header__inner md-grid" aria-label="Header">
-    <a href="../.." title="Tablite" class="md-header__button md-logo" aria-label="Tablite" data-md-component="logo">
-      
-  
-  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
-
-    </a>
-    <label class="md-header__button md-icon" for="__drawer">
-      
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
-    </label>
-    <div class="md-header__title" data-md-component="header-title">
-      <div class="md-header__ellipsis">
-        <div class="md-header__topic">
-          <span class="md-ellipsis">
-            Tablite
-          </span>
-        </div>
-        <div class="md-header__topic" data-md-component="header-topic">
-          <span class="md-ellipsis">
-            
-              Groupbys
-            
-          </span>
-        </div>
-      </div>
-    </div>
-    
-      
-    
-    
-    
-    
-      <label class="md-header__button md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-      </label>
-      <div class="md-search" data-md-component="search" role="dialog">
-  <label class="md-search__overlay" for="__search"></label>
-  <div class="md-search__inner" role="search">
-    <form class="md-search__form" name="search">
-      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
-      <label class="md-search__icon md-icon" for="__search">
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
-        
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
-      </label>
-      <nav class="md-search__options" aria-label="Search">
-        
-        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
-          
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
-        </button>
-      </nav>
-      
-        <div class="md-search__suggest" data-md-component="search-suggest"></div>
-      
-    </form>
-    <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
-        <div class="md-search-result" data-md-component="search-result">
-          <div class="md-search-result__meta">
-            Initializing search
-          </div>
-          <ol class="md-search-result__list" role="presentation"></ol>
-        </div>
-      </div>
-    </div>
-  </div>
-</div>
-    
-    
-      <div class="md-header__source">
-        <a href="https://github.com/root-11/tablite/" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-      </div>
-    
-  </nav>
-  
-    
-      
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../.." class="md-tabs__link">
-          
-  
-    
-  
-  Home
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-    
-  
-  
-    
-    
-      <li class="md-tabs__item md-tabs__item--active">
-        <a href="../base/" class="md-tabs__link">
-          
-  
-    
-  
-  Reference
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-    
-  
-</header>
-    
-    <div class="md-container" data-md-component="container">
-      
-      
-        
-      
-      <main class="md-main" data-md-component="main">
-        <div class="md-main__inner md-grid">
-          
-            
-              
-              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-
-  
-
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
-  <label class="md-nav__title" for="__drawer">
-    <a href="../.." title="Tablite" class="md-nav__button md-logo" aria-label="Tablite" data-md-component="logo">
-      
-  
-  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
-
-    </a>
-    Tablite
-  </label>
-  
-    <div class="md-nav__source">
-      <a href="https://github.com/root-11/tablite/" title="Go to repository" class="md-source" data-md-component="source">
-  <div class="md-source__icon md-icon">
-    
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
-  </div>
-  <div class="md-source__repository">
-    GitHub
-  </div>
-</a>
-    </div>
-  
-  <ul class="md-nav__list" data-md-scrollfix>
-    
-      
-      
-  
-  
-  
-  
-    
-    
-      
-        
-          
-        
-      
-        
-      
-        
-      
-        
-      
-    
-    
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--nested">
-      
-        
-        
-          
-        
-        <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_1" >
-        
-          
-          
-          <div class="md-nav__link md-nav__container">
-            <a href="../.." class="md-nav__link ">
-              
-  
-  <span class="md-ellipsis">
-    Home
-  </span>
-  
-
-            </a>
-            
-              
-              <label class="md-nav__link " for="__nav_1" id="__nav_1_label" tabindex="0">
-                <span class="md-nav__icon md-icon"></span>
-              </label>
-            
-          </div>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_1_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_1">
-            <span class="md-nav__icon md-icon"></span>
-            Home
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../changelog/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Changelog
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../benchmarks/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Benchmarks
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../tutorial/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tutorial
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-      
-      
-  
-  
-    
-  
-  
-  
-    
-    
-      
-        
-      
-        
-      
-        
-      
-        
-      
-        
-      
-        
-      
-        
-      
-        
-      
-        
-      
-        
-      
-        
-      
-        
-      
-        
-      
-        
-      
-        
-      
-        
-      
-        
-      
-        
-      
-        
-      
-        
-      
-        
-      
-        
-      
-        
-      
-        
-      
-        
-      
-        
-      
-    
-    
-      
-        
-        
-      
-      
-    
-    
-    <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
-      
-        
-        
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" checked>
-        
-          
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="">
-            
-  
-  <span class="md-ellipsis">
-    Reference
-  </span>
-  
-
-            <span class="md-nav__icon md-icon"></span>
-          </label>
-        
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_2">
-            <span class="md-nav__icon md-icon"></span>
-            Reference
-          </label>
-          <ul class="md-nav__list" data-md-scrollfix>
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../base/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Base
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../config/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Config
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../core/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Core
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../datasets/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Datasets
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../datatypes/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Datatypes
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../diff/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Diff
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../export_utils/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Export utils
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../file_reader_utils/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    File reader utils
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../groupby_utils/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupby utils
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#tablite.groupbys" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;groupbys
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" groupbys">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupbys-classes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Classes
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupbys-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupbys.groupby" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;groupby
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../import_utils/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Import utils
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../imputation/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Imputation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../joins/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Joins
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../lookup/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Lookup
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../match/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Match
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../merge/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Merge
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../mp_utils/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Mp utils
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../nimlite/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Nimlite
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../pivots/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Pivots
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../redux/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Redux
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../reindex/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Reindex
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sort_utils/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sort utils
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../sortation/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Sortation
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../tools/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Tools
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../utils/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Utils
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../version/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Version
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-          </ul>
-        </nav>
-      
-    </li>
-  
-
-    
-  </ul>
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-            
-              
-              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
-                <div class="md-sidebar__scrollwrap">
-                  <div class="md-sidebar__inner">
-                    
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#tablite.groupbys" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;groupbys
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label=" groupbys">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupbys-classes" class="md-nav__link">
-    <span class="md-ellipsis">
-      Classes
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupbys-functions" class="md-nav__link">
-    <span class="md-ellipsis">
-      Functions
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Functions">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#tablite.groupbys.groupby" class="md-nav__link">
-    <span class="md-ellipsis">
-      &nbsp;groupby
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-                  </div>
-                </div>
-              </div>
-            
-          
-          
-            <div class="md-content" data-md-component="content">
-              <article class="md-content__inner md-typeset">
-                
-                  
-
-
-  <h1>Groupbys</h1>
-
-<div class="doc doc-object doc-module">
-
-
-
-<h2 id="tablite.groupbys" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>          <code>tablite.groupbys</code>
-
-
-</h2>
-
-  <div class="doc doc-contents first">
-
-  
-
-  <div class="doc doc-children">
-
-
-
-
-
-
-<h3 id="tablite.groupbys-classes">Classes</h3>
-<h3 id="tablite.groupbys-functions">Functions</h3>
-
-
-<div class="doc doc-object doc-function">
-
-
-
-<h4 id="tablite.groupbys.groupby" class="doc doc-heading">
-<code class="doc-symbol doc-symbol-heading doc-symbol-function"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">groupbys</span><span class="o">.</span><span class="n">groupby</span><span class="p">(</span><span class="n">T</span><span class="p">,</span> <span class="n">keys</span><span class="p">,</span> <span class="n">functions</span><span class="p">,</span> <span class="n">tqdm</span><span class="o">=</span><span class="n">_tqdm</span><span class="p">,</span> <span class="n">pbar</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
-
-</h4>
-
-
-  <div class="doc doc-contents ">
-  
-      <p>keys: column names for grouping.
-functions: [optional] list of column names and group functions (See GroupyBy class)
-returns: table</p>
-<p>Example:</p>
-<pre><code>&gt;&gt;&gt; t = Table()
-&gt;&gt;&gt; t.add_column('A', data=[1, 1, 2, 2, 3, 3] * 2)
-&gt;&gt;&gt; t.add_column('B', data=[1, 2, 3, 4, 5, 6] * 2)
-&gt;&gt;&gt; t.add_column('C', data=[6, 5, 4, 3, 2, 1] * 2)
-&gt;&gt;&gt; t.show()
-+=====+=====+=====+
-|  A  |  B  |  C  |
-| int | int | int |
-+-----+-----+-----+
-|    1|    1|    6|
-|    1|    2|    5|
-|    2|    3|    4|
-|    2|    4|    3|
-|    3|    5|    2|
-|    3|    6|    1|
-|    1|    1|    6|
-|    1|    2|    5|
-|    2|    3|    4|
-|    2|    4|    3|
-|    3|    5|    2|
-|    3|    6|    1|
-+=====+=====+=====+
-&gt;&gt;&gt; g = t.groupby(keys=['A', 'C'], functions=[('B', gb.sum)])
-&gt;&gt;&gt; g.show()
-+===+===+===+======+
-| # | A | C |Sum(B)|
-|row|int|int| int  |
-+---+---+---+------+
-|0  |  1|  6|     2|
-|1  |  1|  5|     4|
-|2  |  2|  4|     6|
-|3  |  2|  3|     8|
-|4  |  3|  2|    10|
-|5  |  3|  1|    12|
-+===+===+===+======+
-</code></pre>
-<p>Cheat sheet:</p>
-<p>list of unique values</p>
-<pre><code>&gt;&gt;&gt; g1 = t.groupby(keys=['A'], functions=[])
-&gt;&gt;&gt; g1['A'][:]
-[1,2,3]
-</code></pre>
-<p>alternatively:</p>
-<pre><code>&gt;&gt;&gt; t['A'].unique()
-[1,2,3]
-</code></pre>
-<p>list of unique values, grouped by longest combination.</p>
-<pre><code>&gt;&gt;&gt; g2 = t.groupby(keys=['A', 'B'], functions=[])
-&gt;&gt;&gt; g2['A'][:], g2['B'][:]
-([1,1,2,2,3,3], [1,2,3,4,5,6])
-</code></pre>
-<p>alternatively use:</p>
-<pre><code>&gt;&gt;&gt; list(zip(*t.index('A', 'B').keys()))
-[(1,1,2,2,3,3) (1,2,3,4,5,6)]
-</code></pre>
-<p>A key (unique values) and count hereof.</p>
-<pre><code>&gt;&gt;&gt; g3 = t.groupby(keys=['A'], functions=[('A', gb.count)])
-&gt;&gt;&gt; g3['A'][:], g3['Count(A)'][:]
-([1,2,3], [4,4,4])
-</code></pre>
-<p>alternatively use:</p>
-<pre><code>&gt;&gt;&gt; t['A'].histogram()
-([1,2,3], [4,4,4])
-</code></pre>
-<p>for more examples see: https://github.com/root-11/tablite/blob/master/tests/test_groupby.py</p>
-
-          <details class="quote">
-            <summary>Source code in <code>tablite/groupbys.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 11</span>
-<span class="normal"> 12</span>
-<span class="normal"> 13</span>
-<span class="normal"> 14</span>
-<span class="normal"> 15</span>
-<span class="normal"> 16</span>
-<span class="normal"> 17</span>
-<span class="normal"> 18</span>
-<span class="normal"> 19</span>
-<span class="normal"> 20</span>
-<span class="normal"> 21</span>
-<span class="normal"> 22</span>
-<span class="normal"> 23</span>
-<span class="normal"> 24</span>
-<span class="normal"> 25</span>
-<span class="normal"> 26</span>
-<span class="normal"> 27</span>
-<span class="normal"> 28</span>
-<span class="normal"> 29</span>
-<span class="normal"> 30</span>
-<span class="normal"> 31</span>
-<span class="normal"> 32</span>
-<span class="normal"> 33</span>
-<span class="normal"> 34</span>
-<span class="normal"> 35</span>
-<span class="normal"> 36</span>
-<span class="normal"> 37</span>
-<span class="normal"> 38</span>
-<span class="normal"> 39</span>
-<span class="normal"> 40</span>
-<span class="normal"> 41</span>
-<span class="normal"> 42</span>
-<span class="normal"> 43</span>
-<span class="normal"> 44</span>
-<span class="normal"> 45</span>
-<span class="normal"> 46</span>
-<span class="normal"> 47</span>
-<span class="normal"> 48</span>
-<span class="normal"> 49</span>
-<span class="normal"> 50</span>
-<span class="normal"> 51</span>
-<span class="normal"> 52</span>
-<span class="normal"> 53</span>
-<span class="normal"> 54</span>
-<span class="normal"> 55</span>
-<span class="normal"> 56</span>
-<span class="normal"> 57</span>
-<span class="normal"> 58</span>
-<span class="normal"> 59</span>
-<span class="normal"> 60</span>
-<span class="normal"> 61</span>
-<span class="normal"> 62</span>
-<span class="normal"> 63</span>
-<span class="normal"> 64</span>
-<span class="normal"> 65</span>
-<span class="normal"> 66</span>
-<span class="normal"> 67</span>
-<span class="normal"> 68</span>
-<span class="normal"> 69</span>
-<span class="normal"> 70</span>
-<span class="normal"> 71</span>
-<span class="normal"> 72</span>
-<span class="normal"> 73</span>
-<span class="normal"> 74</span>
-<span class="normal"> 75</span>
-<span class="normal"> 76</span>
-<span class="normal"> 77</span>
-<span class="normal"> 78</span>
-<span class="normal"> 79</span>
-<span class="normal"> 80</span>
-<span class="normal"> 81</span>
-<span class="normal"> 82</span>
-<span class="normal"> 83</span>
-<span class="normal"> 84</span>
-<span class="normal"> 85</span>
-<span class="normal"> 86</span>
-<span class="normal"> 87</span>
-<span class="normal"> 88</span>
-<span class="normal"> 89</span>
-<span class="normal"> 90</span>
-<span class="normal"> 91</span>
-<span class="normal"> 92</span>
-<span class="normal"> 93</span>
-<span class="normal"> 94</span>
-<span class="normal"> 95</span>
-<span class="normal"> 96</span>
-<span class="normal"> 97</span>
-<span class="normal"> 98</span>
-<span class="normal"> 99</span>
-<span class="normal">100</span>
-<span class="normal">101</span>
-<span class="normal">102</span>
-<span class="normal">103</span>
-<span class="normal">104</span>
-<span class="normal">105</span>
-<span class="normal">106</span>
-<span class="normal">107</span>
-<span class="normal">108</span>
-<span class="normal">109</span>
-<span class="normal">110</span>
-<span class="normal">111</span>
-<span class="normal">112</span>
-<span class="normal">113</span>
-<span class="normal">114</span>
-<span class="normal">115</span>
-<span class="normal">116</span>
-<span class="normal">117</span>
-<span class="normal">118</span>
-<span class="normal">119</span>
-<span class="normal">120</span>
-<span class="normal">121</span>
-<span class="normal">122</span>
-<span class="normal">123</span>
-<span class="normal">124</span>
-<span class="normal">125</span>
-<span class="normal">126</span>
-<span class="normal">127</span>
-<span class="normal">128</span>
-<span class="normal">129</span>
-<span class="normal">130</span>
-<span class="normal">131</span>
-<span class="normal">132</span>
-<span class="normal">133</span>
-<span class="normal">134</span>
-<span class="normal">135</span>
-<span class="normal">136</span>
-<span class="normal">137</span>
-<span class="normal">138</span>
-<span class="normal">139</span>
-<span class="normal">140</span>
-<span class="normal">141</span>
-<span class="normal">142</span>
-<span class="normal">143</span>
-<span class="normal">144</span>
-<span class="normal">145</span>
-<span class="normal">146</span>
-<span class="normal">147</span>
-<span class="normal">148</span>
-<span class="normal">149</span>
-<span class="normal">150</span>
-<span class="normal">151</span>
-<span class="normal">152</span>
-<span class="normal">153</span>
-<span class="normal">154</span>
-<span class="normal">155</span>
-<span class="normal">156</span>
-<span class="normal">157</span>
-<span class="normal">158</span>
-<span class="normal">159</span>
-<span class="normal">160</span>
-<span class="normal">161</span>
-<span class="normal">162</span>
-<span class="normal">163</span>
-<span class="normal">164</span>
-<span class="normal">165</span>
-<span class="normal">166</span>
-<span class="normal">167</span>
-<span class="normal">168</span>
-<span class="normal">169</span>
-<span class="normal">170</span>
-<span class="normal">171</span>
-<span class="normal">172</span>
-<span class="normal">173</span>
-<span class="normal">174</span>
-<span class="normal">175</span>
-<span class="normal">176</span>
-<span class="normal">177</span>
-<span class="normal">178</span>
-<span class="normal">179</span>
-<span class="normal">180</span>
-<span class="normal">181</span>
-<span class="normal">182</span>
-<span class="normal">183</span>
-<span class="normal">184</span>
-<span class="normal">185</span>
-<span class="normal">186</span>
-<span class="normal">187</span>
-<span class="normal">188</span>
-<span class="normal">189</span>
-<span class="normal">190</span>
-<span class="normal">191</span>
-<span class="normal">192</span>
-<span class="normal">193</span>
-<span class="normal">194</span>
-<span class="normal">195</span>
-<span class="normal">196</span>
-<span class="normal">197</span>
-<span class="normal">198</span>
-<span class="normal">199</span>
-<span class="normal">200</span>
-<span class="normal">201</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">groupby</span><span class="p">(</span>
-    <span class="n">T</span><span class="p">,</span> <span class="n">keys</span><span class="p">,</span> <span class="n">functions</span><span class="p">,</span> <span class="n">tqdm</span><span class="o">=</span><span class="n">_tqdm</span><span class="p">,</span> <span class="n">pbar</span><span class="o">=</span><span class="kc">None</span>
-<span class="p">):</span>  <span class="c1"># TODO: This is single core code.</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">    keys: column names for grouping.</span>
-<span class="sd">    functions: [optional] list of column names and group functions (See GroupyBy class)</span>
-<span class="sd">    returns: table</span>
-
-<span class="sd">    Example:</span>
-<span class="sd">    ```</span>
-<span class="sd">    &gt;&gt;&gt; t = Table()</span>
-<span class="sd">    &gt;&gt;&gt; t.add_column(&#39;A&#39;, data=[1, 1, 2, 2, 3, 3] * 2)</span>
-<span class="sd">    &gt;&gt;&gt; t.add_column(&#39;B&#39;, data=[1, 2, 3, 4, 5, 6] * 2)</span>
-<span class="sd">    &gt;&gt;&gt; t.add_column(&#39;C&#39;, data=[6, 5, 4, 3, 2, 1] * 2)</span>
-<span class="sd">    &gt;&gt;&gt; t.show()</span>
-<span class="sd">    +=====+=====+=====+</span>
-<span class="sd">    |  A  |  B  |  C  |</span>
-<span class="sd">    | int | int | int |</span>
-<span class="sd">    +-----+-----+-----+</span>
-<span class="sd">    |    1|    1|    6|</span>
-<span class="sd">    |    1|    2|    5|</span>
-<span class="sd">    |    2|    3|    4|</span>
-<span class="sd">    |    2|    4|    3|</span>
-<span class="sd">    |    3|    5|    2|</span>
-<span class="sd">    |    3|    6|    1|</span>
-<span class="sd">    |    1|    1|    6|</span>
-<span class="sd">    |    1|    2|    5|</span>
-<span class="sd">    |    2|    3|    4|</span>
-<span class="sd">    |    2|    4|    3|</span>
-<span class="sd">    |    3|    5|    2|</span>
-<span class="sd">    |    3|    6|    1|</span>
-<span class="sd">    +=====+=====+=====+</span>
-<span class="sd">    &gt;&gt;&gt; g = t.groupby(keys=[&#39;A&#39;, &#39;C&#39;], functions=[(&#39;B&#39;, gb.sum)])</span>
-<span class="sd">    &gt;&gt;&gt; g.show()</span>
-<span class="sd">    +===+===+===+======+</span>
-<span class="sd">    | # | A | C |Sum(B)|</span>
-<span class="sd">    |row|int|int| int  |</span>
-<span class="sd">    +---+---+---+------+</span>
-<span class="sd">    |0  |  1|  6|     2|</span>
-<span class="sd">    |1  |  1|  5|     4|</span>
-<span class="sd">    |2  |  2|  4|     6|</span>
-<span class="sd">    |3  |  2|  3|     8|</span>
-<span class="sd">    |4  |  3|  2|    10|</span>
-<span class="sd">    |5  |  3|  1|    12|</span>
-<span class="sd">    +===+===+===+======+</span>
-<span class="sd">    ```</span>
-
-<span class="sd">    Cheat sheet:</span>
-
-<span class="sd">    list of unique values</span>
-<span class="sd">    ```</span>
-<span class="sd">    &gt;&gt;&gt; g1 = t.groupby(keys=[&#39;A&#39;], functions=[])</span>
-<span class="sd">    &gt;&gt;&gt; g1[&#39;A&#39;][:]</span>
-<span class="sd">    [1,2,3]</span>
-<span class="sd">    ```</span>
-<span class="sd">    alternatively:</span>
-<span class="sd">    ```</span>
-<span class="sd">    &gt;&gt;&gt; t[&#39;A&#39;].unique()</span>
-<span class="sd">    [1,2,3]</span>
-<span class="sd">    ```</span>
-<span class="sd">    list of unique values, grouped by longest combination.</span>
-<span class="sd">    ```</span>
-<span class="sd">    &gt;&gt;&gt; g2 = t.groupby(keys=[&#39;A&#39;, &#39;B&#39;], functions=[])</span>
-<span class="sd">    &gt;&gt;&gt; g2[&#39;A&#39;][:], g2[&#39;B&#39;][:]</span>
-<span class="sd">    ([1,1,2,2,3,3], [1,2,3,4,5,6])</span>
-<span class="sd">    ```</span>
-<span class="sd">    alternatively use:</span>
-<span class="sd">    ```</span>
-<span class="sd">    &gt;&gt;&gt; list(zip(*t.index(&#39;A&#39;, &#39;B&#39;).keys()))</span>
-<span class="sd">    [(1,1,2,2,3,3) (1,2,3,4,5,6)]</span>
-<span class="sd">    ```</span>
-
-<span class="sd">    A key (unique values) and count hereof.</span>
-<span class="sd">    ```</span>
-<span class="sd">    &gt;&gt;&gt; g3 = t.groupby(keys=[&#39;A&#39;], functions=[(&#39;A&#39;, gb.count)])</span>
-<span class="sd">    &gt;&gt;&gt; g3[&#39;A&#39;][:], g3[&#39;Count(A)&#39;][:]</span>
-<span class="sd">    ([1,2,3], [4,4,4])</span>
-<span class="sd">    ```</span>
-<span class="sd">    alternatively use:</span>
-<span class="sd">    ```</span>
-<span class="sd">    &gt;&gt;&gt; t[&#39;A&#39;].histogram()</span>
-<span class="sd">    ([1,2,3], [4,4,4])</span>
-<span class="sd">    ```</span>
-<span class="sd">    for more examples see: https://github.com/root-11/tablite/blob/master/tests/test_groupby.py</span>
-
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">keys</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span>
-        <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="s2">&quot;expected keys as a list of column names&quot;</span><span class="p">)</span>
-
-    <span class="k">if</span> <span class="n">keys</span><span class="p">:</span>
-        <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="nb">set</span><span class="p">(</span><span class="n">keys</span><span class="p">))</span> <span class="o">!=</span> <span class="nb">len</span><span class="p">(</span><span class="n">keys</span><span class="p">):</span>
-            <span class="n">duplicates</span> <span class="o">=</span> <span class="p">[</span><span class="n">k</span> <span class="k">for</span> <span class="n">k</span> <span class="ow">in</span> <span class="n">keys</span> <span class="k">if</span> <span class="n">keys</span><span class="o">.</span><span class="n">count</span><span class="p">(</span><span class="n">k</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">]</span>
-            <span class="n">s</span> <span class="o">=</span> <span class="s2">&quot;&quot;</span> <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">duplicates</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">1</span> <span class="k">else</span> <span class="s2">&quot;s&quot;</span>
-            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-                <span class="sa">f</span><span class="s2">&quot;duplicate key</span><span class="si">{</span><span class="n">s</span><span class="si">}</span><span class="s2"> found across rows and columns: </span><span class="si">{</span><span class="n">duplicates</span><span class="si">}</span><span class="s2">&quot;</span>
-            <span class="p">)</span>
-
-    <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">functions</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span>
-        <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span>
-            <span class="sa">f</span><span class="s2">&quot;Expected functions to be a list of tuples. Got </span><span class="si">{</span><span class="nb">type</span><span class="p">(</span><span class="n">functions</span><span class="p">)</span><span class="si">}</span><span class="s2">&quot;</span>
-        <span class="p">)</span>
-
-    <span class="k">if</span> <span class="ow">not</span> <span class="n">keys</span> <span class="o">+</span> <span class="n">functions</span><span class="p">:</span>
-        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;No keys or functions?&quot;</span><span class="p">)</span>
-
-    <span class="k">if</span> <span class="ow">not</span> <span class="nb">all</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">i</span><span class="p">)</span> <span class="o">==</span> <span class="mi">2</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="n">functions</span><span class="p">):</span>
-        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-            <span class="sa">f</span><span class="s2">&quot;Expected each tuple in functions to be of length 2. </span><span class="se">\n</span><span class="s2">Got </span><span class="si">{</span><span class="n">functions</span><span class="si">}</span><span class="s2">&quot;</span>
-        <span class="p">)</span>
-
-    <span class="k">if</span> <span class="ow">not</span> <span class="nb">all</span><span class="p">(</span><span class="nb">isinstance</span><span class="p">(</span><span class="n">a</span><span class="p">,</span> <span class="nb">str</span><span class="p">)</span> <span class="k">for</span> <span class="n">a</span><span class="p">,</span> <span class="n">_</span> <span class="ow">in</span> <span class="n">functions</span><span class="p">):</span>
-        <span class="n">L</span> <span class="o">=</span> <span class="p">[(</span><span class="n">a</span><span class="p">,</span> <span class="nb">type</span><span class="p">(</span><span class="n">a</span><span class="p">))</span> <span class="k">for</span> <span class="n">a</span><span class="p">,</span> <span class="n">_</span> <span class="ow">in</span> <span class="n">functions</span> <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">a</span><span class="p">,</span> <span class="nb">str</span><span class="p">)]</span>
-        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-            <span class="sa">f</span><span class="s2">&quot;Expected column names in functions to be strings. Found: </span><span class="si">{</span><span class="n">L</span><span class="si">}</span><span class="s2">&quot;</span>
-        <span class="p">)</span>
-
-    <span class="k">if</span> <span class="ow">not</span> <span class="nb">all</span><span class="p">(</span>
-        <span class="nb">issubclass</span><span class="p">(</span><span class="n">b</span><span class="p">,</span> <span class="n">GroupbyFunction</span><span class="p">)</span> <span class="ow">and</span> <span class="n">b</span> <span class="ow">in</span> <span class="n">GroupBy</span><span class="o">.</span><span class="n">functions</span> <span class="k">for</span> <span class="n">_</span><span class="p">,</span> <span class="n">b</span> <span class="ow">in</span> <span class="n">functions</span>
-    <span class="p">):</span>
-        <span class="n">L</span> <span class="o">=</span> <span class="p">[</span><span class="n">b</span> <span class="k">for</span> <span class="n">_</span><span class="p">,</span> <span class="n">b</span> <span class="ow">in</span> <span class="n">functions</span> <span class="k">if</span> <span class="n">b</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">GroupBy</span><span class="o">.</span><span class="n">_functions</span><span class="p">]</span>
-        <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">L</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
-            <span class="n">singular</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;function </span><span class="si">{</span><span class="n">L</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="si">}</span><span class="s2"> is not in GroupBy.functions&quot;</span>
-            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="n">singular</span><span class="p">)</span>
-        <span class="k">else</span><span class="p">:</span>
-            <span class="n">plural</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;the functions </span><span class="si">{</span><span class="n">L</span><span class="si">}</span><span class="s2"> are not in GroupBy.functions&quot;</span>
-            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="n">plural</span><span class="p">)</span>
-
-    <span class="c1"># only keys will produce unique values for each key group.</span>
-    <span class="k">if</span> <span class="n">keys</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">functions</span><span class="p">:</span>
-        <span class="n">cols</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="nb">zip</span><span class="p">(</span><span class="o">*</span><span class="n">T</span><span class="o">.</span><span class="n">index</span><span class="p">(</span><span class="o">*</span><span class="n">keys</span><span class="p">)))</span>
-        <span class="n">result</span> <span class="o">=</span> <span class="n">T</span><span class="o">.</span><span class="vm">__class__</span><span class="p">()</span>
-
-        <span class="n">pbar</span> <span class="o">=</span> <span class="n">tqdm</span><span class="p">(</span><span class="n">total</span><span class="o">=</span><span class="nb">len</span><span class="p">(</span><span class="n">keys</span><span class="p">),</span> <span class="n">desc</span><span class="o">=</span><span class="s2">&quot;groupby&quot;</span><span class="p">)</span> <span class="k">if</span> <span class="n">pbar</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">pbar</span>
-
-        <span class="k">for</span> <span class="n">col_name</span><span class="p">,</span> <span class="n">col</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span><span class="n">keys</span><span class="p">,</span> <span class="n">cols</span><span class="p">):</span>
-            <span class="n">result</span><span class="p">[</span><span class="n">col_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">col</span>
-
-            <span class="n">pbar</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
-        <span class="k">return</span> <span class="n">result</span>
-
-    <span class="c1"># grouping is required...</span>
-    <span class="c1"># 1. Aggregate data.</span>
-    <span class="n">aggregation_functions</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="nb">dict</span><span class="p">)</span>
-    <span class="n">cols</span> <span class="o">=</span> <span class="n">keys</span> <span class="o">+</span> <span class="p">[</span><span class="n">col_name</span> <span class="k">for</span> <span class="n">col_name</span><span class="p">,</span> <span class="n">_</span> <span class="ow">in</span> <span class="n">functions</span><span class="p">]</span>
-    <span class="n">seen</span><span class="p">,</span> <span class="n">L</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(),</span> <span class="p">[]</span>
-    <span class="k">for</span> <span class="n">c</span> <span class="ow">in</span> <span class="n">cols</span><span class="p">:</span>  <span class="c1"># maintains order of appearance.</span>
-        <span class="k">if</span> <span class="n">c</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">seen</span><span class="p">:</span>
-            <span class="n">seen</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">c</span><span class="p">)</span>
-            <span class="n">L</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">c</span><span class="p">)</span>
-
-    <span class="c1"># there&#39;s a table of values.</span>
-    <span class="n">data</span> <span class="o">=</span> <span class="n">T</span><span class="p">[</span><span class="n">L</span><span class="p">]</span>
-    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="n">Column</span><span class="p">):</span>
-        <span class="n">tbl</span> <span class="o">=</span> <span class="n">BaseTable</span><span class="p">()</span>
-        <span class="n">tbl</span><span class="p">[</span><span class="n">L</span><span class="p">[</span><span class="mi">0</span><span class="p">]]</span> <span class="o">=</span> <span class="n">data</span>
-    <span class="k">else</span><span class="p">:</span>
-        <span class="n">tbl</span> <span class="o">=</span> <span class="n">data</span>
-
-    <span class="n">pbar</span> <span class="o">=</span> <span class="p">(</span>
-        <span class="n">tqdm</span><span class="p">(</span><span class="n">desc</span><span class="o">=</span><span class="s2">&quot;groupby&quot;</span><span class="p">,</span> <span class="n">total</span><span class="o">=</span><span class="nb">len</span><span class="p">(</span><span class="n">tbl</span><span class="p">),</span> <span class="n">disable</span><span class="o">=</span><span class="n">Config</span><span class="o">.</span><span class="n">TQDM_DISABLE</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">pbar</span> <span class="ow">is</span> <span class="kc">None</span>
-        <span class="k">else</span> <span class="n">pbar</span>
-    <span class="p">)</span>
-
-    <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">tbl</span><span class="o">.</span><span class="n">rows</span><span class="p">:</span>
-        <span class="n">d</span> <span class="o">=</span> <span class="p">{</span><span class="n">col_name</span><span class="p">:</span> <span class="n">value</span> <span class="k">for</span> <span class="n">col_name</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span><span class="n">L</span><span class="p">,</span> <span class="n">row</span><span class="p">)}</span>
-        <span class="n">key</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">([</span><span class="n">d</span><span class="p">[</span><span class="n">k</span><span class="p">]</span> <span class="k">for</span> <span class="n">k</span> <span class="ow">in</span> <span class="n">keys</span><span class="p">])</span>
-        <span class="n">agg_functions</span> <span class="o">=</span> <span class="n">aggregation_functions</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
-        <span class="k">if</span> <span class="ow">not</span> <span class="n">agg_functions</span><span class="p">:</span>
-            <span class="n">aggregation_functions</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">agg_functions</span> <span class="o">=</span> <span class="p">[</span>
-                <span class="p">(</span><span class="n">col_name</span><span class="p">,</span> <span class="n">f</span><span class="p">())</span> <span class="k">for</span> <span class="n">col_name</span><span class="p">,</span> <span class="n">f</span> <span class="ow">in</span> <span class="n">functions</span>
-            <span class="p">]</span>
-        <span class="k">for</span> <span class="n">col_name</span><span class="p">,</span> <span class="n">f</span> <span class="ow">in</span> <span class="n">agg_functions</span><span class="p">:</span>
-            <span class="n">f</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">d</span><span class="p">[</span><span class="n">col_name</span><span class="p">])</span>
-
-        <span class="n">pbar</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
-
-    <span class="c1"># 2. make dense table.</span>
-    <span class="n">cols</span> <span class="o">=</span> <span class="p">[[]</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="n">cols</span><span class="p">]</span>
-    <span class="k">for</span> <span class="n">key_tuple</span><span class="p">,</span> <span class="n">funcs</span> <span class="ow">in</span> <span class="n">aggregation_functions</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
-        <span class="k">for</span> <span class="n">ix</span><span class="p">,</span> <span class="n">key_value</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">key_tuple</span><span class="p">):</span>
-            <span class="n">cols</span><span class="p">[</span><span class="n">ix</span><span class="p">]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">key_value</span><span class="p">)</span>
-        <span class="k">for</span> <span class="n">ix</span><span class="p">,</span> <span class="p">(</span><span class="n">_</span><span class="p">,</span> <span class="n">f</span><span class="p">)</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">funcs</span><span class="p">,</span> <span class="n">start</span><span class="o">=</span><span class="nb">len</span><span class="p">(</span><span class="n">keys</span><span class="p">)):</span>
-            <span class="n">cols</span><span class="p">[</span><span class="n">ix</span><span class="p">]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">f</span><span class="o">.</span><span class="n">value</span><span class="p">)</span>
-
-    <span class="n">new_names</span> <span class="o">=</span> <span class="n">keys</span> <span class="o">+</span> <span class="p">[</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">f</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">(</span><span class="si">{</span><span class="n">col_name</span><span class="si">}</span><span class="s2">)&quot;</span> <span class="k">for</span> <span class="n">col_name</span><span class="p">,</span> <span class="n">f</span> <span class="ow">in</span> <span class="n">functions</span><span class="p">]</span>
-    <span class="n">result</span> <span class="o">=</span> <span class="nb">type</span><span class="p">(</span><span class="n">T</span><span class="p">)()</span>  <span class="c1"># New Table.</span>
-    <span class="k">for</span> <span class="n">ix</span><span class="p">,</span> <span class="p">(</span><span class="n">col_name</span><span class="p">,</span> <span class="n">data</span><span class="p">)</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="nb">zip</span><span class="p">(</span><span class="n">new_names</span><span class="p">,</span> <span class="n">cols</span><span class="p">)):</span>
-        <span class="n">revised_name</span> <span class="o">=</span> <span class="n">unique_name</span><span class="p">(</span><span class="n">col_name</span><span class="p">,</span> <span class="n">result</span><span class="o">.</span><span class="n">columns</span><span class="p">)</span>
-        <span class="n">result</span><span class="p">[</span><span class="n">revised_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">data</span>
-    <span class="k">return</span> <span class="n">result</span>
-</code></pre></div></td></tr></table></div>
-          </details>
-  </div>
-
-</div>
-
-
-
-  </div>
-
-  </div>
-
-</div>
-
-
-
-
-
-
-
-
-
-
-
-
-                
-              </article>
-            </div>
-          
-          
-<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
-        </div>
-        
-          <button type="button" class="md-top md-icon" data-md-component="top" hidden>
-  
-  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12Z"/></svg>
-  Back to top
-</button>
-        
-      </main>
-      
-        <footer class="md-footer">
-  
-  <div class="md-footer-meta md-typeset">
-    <div class="md-footer-meta__inner md-grid">
-      <div class="md-copyright">
-  
-  
-</div>
-      
-    </div>
-  </div>
-</footer>
-      
-    </div>
-    <div class="md-dialog" data-md-component="dialog">
-      <div class="md-dialog__inner md-typeset"></div>
-    </div>
-    
-    
-    <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.tabs", "navigation.tabs.sticky", "navigation.expand", "navigation.indexes", "navigation.top", "toc.follow", "search.suggest", "search.highlight"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"provider": "mike"}}</script>
-    
-    
-      <script src="../../assets/javascripts/bundle.1e8ae164.min.js"></script>
-      
-    
-  </body>
-</html>
\ No newline at end of file
diff --git a/master/reference/import_utils/index.html b/master/reference/import_utils/index.html
index e262d22c..db30a8f1 100644
--- a/master/reference/import_utils/index.html
+++ b/master/reference/import_utils/index.html
@@ -13,7 +13,7 @@
         <link rel="canonical" href="https://root-11.github.io/tablite/master/reference/import_utils/">
       
       
-        <link rel="prev" href="../groupbys/">
+        <link rel="prev" href="../groupby_utils/">
       
       
         <link rel="next" href="../imputation/">
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -705,27 +703,6 @@
                 
   
   
-  
-  
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
     
   
   
diff --git a/master/reference/imputation/index.html b/master/reference/imputation/index.html
index ec81f53f..910ebff7 100644
--- a/master/reference/imputation/index.html
+++ b/master/reference/imputation/index.html
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -707,27 +705,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
diff --git a/master/reference/joins/index.html b/master/reference/joins/index.html
index 8d416ef7..e3f5e84a 100644
--- a/master/reference/joins/index.html
+++ b/master/reference/joins/index.html
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -707,27 +705,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
diff --git a/master/reference/lookup/index.html b/master/reference/lookup/index.html
index 86dba773..7aa67969 100644
--- a/master/reference/lookup/index.html
+++ b/master/reference/lookup/index.html
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -707,27 +705,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
diff --git a/master/reference/match/index.html b/master/reference/match/index.html
index a5e65459..73d3c14e 100644
--- a/master/reference/match/index.html
+++ b/master/reference/match/index.html
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -707,27 +705,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
diff --git a/master/reference/merge/index.html b/master/reference/merge/index.html
index 497d435c..aeb4dc4a 100644
--- a/master/reference/merge/index.html
+++ b/master/reference/merge/index.html
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -707,27 +705,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
diff --git a/master/reference/mp_utils/index.html b/master/reference/mp_utils/index.html
index 1a54908e..13118d91 100644
--- a/master/reference/mp_utils/index.html
+++ b/master/reference/mp_utils/index.html
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -707,27 +705,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
diff --git a/master/reference/nimlite/index.html b/master/reference/nimlite/index.html
index 06ac04a6..7c725404 100644
--- a/master/reference/nimlite/index.html
+++ b/master/reference/nimlite/index.html
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -707,27 +705,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
@@ -1103,6 +1080,15 @@
     </span>
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#tablite.nimlite.groupby" class="md-nav__link">
+    <span class="md-ellipsis">
+      &nbsp;groupby
+    </span>
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
@@ -1518,6 +1504,15 @@
     </span>
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#tablite.nimlite.groupby" class="md-nav__link">
+    <span class="md-ellipsis">
+      &nbsp;groupby
+    </span>
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
@@ -2370,6 +2365,30 @@ <h4 id="tablite.nimlite.nearest_neighbour" class="doc doc-heading">
 
 
 
+<h4 id="tablite.nimlite.groupby" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-function"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">nimlite</span><span class="o">.</span><span class="n">groupby</span><span class="p">(</span><span class="n">T</span><span class="p">,</span> <span class="n">keys</span><span class="p">,</span> <span class="n">functions</span><span class="p">,</span> <span class="n">tqdm</span><span class="o">=</span><span class="n">_tqdm</span><span class="p">)</span></code>
+
+</h4>
+
+
+  <div class="doc doc-contents ">
+
+          <details class="quote">
+            <summary>Source code in <code>tablite/nimlite.py</code></summary>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">310</span>
+<span class="normal">311</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">groupby</span><span class="p">(</span><span class="n">T</span><span class="p">,</span> <span class="n">keys</span><span class="p">,</span> <span class="n">functions</span><span class="p">,</span> <span class="n">tqdm</span><span class="o">=</span><span class="n">_tqdm</span><span class="p">):</span>
+    <span class="k">return</span> <span class="n">nl</span><span class="o">.</span><span class="n">groupby</span><span class="p">(</span><span class="n">T</span><span class="p">,</span> <span class="n">keys</span><span class="p">,</span> <span class="n">functions</span><span class="p">,</span> <span class="n">tqdm</span><span class="p">)</span>
+</code></pre></div></td></tr></table></div>
+          </details>
+  </div>
+
+</div>
+
+
+<div class="doc doc-object doc-function">
+
+
+
 <h4 id="tablite.nimlite.filter" class="doc doc-heading">
 <code class="doc-symbol doc-symbol-heading doc-symbol-function"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">nimlite</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="n">table</span><span class="p">:</span> <span class="n">BaseTable</span><span class="p">,</span> <span class="n">expressions</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">FilterDict</span><span class="p">],</span> <span class="nb">type</span><span class="p">:</span> <span class="n">FilterType</span><span class="p">,</span> <span class="n">tqdm</span><span class="o">=</span><span class="n">_tqdm</span><span class="p">)</span></code>
 
@@ -2380,8 +2399,8 @@ <h4 id="tablite.nimlite.filter" class="doc doc-heading">
 
           <details class="quote">
             <summary>Source code in <code>tablite/nimlite.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">310</span>
-<span class="normal">311</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">filter</span><span class="p">(</span><span class="n">table</span><span class="p">:</span> <span class="n">BaseTable</span><span class="p">,</span> <span class="n">expressions</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">FilterDict</span><span class="p">],</span> <span class="nb">type</span><span class="p">:</span> <span class="n">FilterType</span><span class="p">,</span> <span class="n">tqdm</span> <span class="o">=</span> <span class="n">_tqdm</span><span class="p">):</span>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">313</span>
+<span class="normal">314</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">filter</span><span class="p">(</span><span class="n">table</span><span class="p">:</span> <span class="n">BaseTable</span><span class="p">,</span> <span class="n">expressions</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">FilterDict</span><span class="p">],</span> <span class="nb">type</span><span class="p">:</span> <span class="n">FilterType</span><span class="p">,</span> <span class="n">tqdm</span> <span class="o">=</span> <span class="n">_tqdm</span><span class="p">):</span>
     <span class="k">return</span> <span class="n">nl</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="n">table</span><span class="p">,</span> <span class="n">expressions</span><span class="p">,</span> <span class="nb">type</span><span class="p">,</span> <span class="n">tqdm</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
           </details>
diff --git a/master/reference/pivots/index.html b/master/reference/pivots/index.html
index fd16c5d6..928c7512 100644
--- a/master/reference/pivots/index.html
+++ b/master/reference/pivots/index.html
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -707,27 +705,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
@@ -967,6 +944,15 @@
     <nav class="md-nav" aria-label="Functions">
       <ul class="md-nav__list">
         
+          <li class="md-nav__item">
+  <a href="#tablite.pivots.acc2Name" class="md-nav__link">
+    <span class="md-ellipsis">
+      &nbsp;acc2Name
+    </span>
+  </a>
+  
+</li>
+        
           <li class="md-nav__item">
   <a href="#tablite.pivots.pivot" class="md-nav__link">
     <span class="md-ellipsis">
@@ -1220,6 +1206,15 @@
     <nav class="md-nav" aria-label="Functions">
       <ul class="md-nav__list">
         
+          <li class="md-nav__item">
+  <a href="#tablite.pivots.acc2Name" class="md-nav__link">
+    <span class="md-ellipsis">
+      &nbsp;acc2Name
+    </span>
+  </a>
+  
+</li>
+        
           <li class="md-nav__item">
   <a href="#tablite.pivots.pivot" class="md-nav__link">
     <span class="md-ellipsis">
@@ -1303,6 +1298,50 @@ <h3 id="tablite.pivots-functions">Functions</h3>
 
 
 
+<h4 id="tablite.pivots.acc2Name" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-function"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">pivots</span><span class="o">.</span><span class="n">acc2Name</span><span class="p">(</span><span class="n">acc</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span></code>
+
+</h4>
+
+
+  <div class="doc doc-contents ">
+
+          <details class="quote">
+            <summary>Source code in <code>tablite/pivots.py</code></summary>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">12</span>
+<span class="normal">13</span>
+<span class="normal">14</span>
+<span class="normal">15</span>
+<span class="normal">16</span>
+<span class="normal">17</span>
+<span class="normal">18</span>
+<span class="normal">19</span>
+<span class="normal">20</span>
+<span class="normal">21</span>
+<span class="normal">22</span>
+<span class="normal">23</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">acc2Name</span><span class="p">(</span><span class="n">acc</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
+    <span class="n">arr</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&quot;max&quot;</span><span class="p">,</span> <span class="s2">&quot;min&quot;</span><span class="p">,</span> <span class="s2">&quot;sum&quot;</span><span class="p">,</span> <span class="s2">&quot;product&quot;</span><span class="p">,</span> <span class="s2">&quot;first&quot;</span><span class="p">,</span> <span class="s2">&quot;last&quot;</span><span class="p">,</span> <span class="s2">&quot;count&quot;</span><span class="p">,</span> <span class="s2">&quot;median&quot;</span><span class="p">,</span> <span class="s2">&quot;mode&quot;</span><span class="p">]</span>
+    <span class="k">if</span> <span class="n">acc</span> <span class="ow">in</span> <span class="n">arr</span><span class="p">:</span>
+        <span class="k">return</span> <span class="n">acc</span><span class="o">.</span><span class="n">capitalize</span><span class="p">()</span>
+    <span class="k">elif</span> <span class="n">acc</span> <span class="o">==</span> <span class="s2">&quot;count_unique&quot;</span><span class="p">:</span>
+        <span class="k">return</span> <span class="s2">&quot;CountUnique&quot;</span>
+    <span class="k">elif</span> <span class="n">acc</span> <span class="o">==</span> <span class="s2">&quot;avg&quot;</span><span class="p">:</span>
+        <span class="k">return</span> <span class="s2">&quot;Average&quot;</span>
+    <span class="k">elif</span> <span class="n">acc</span> <span class="o">==</span> <span class="s2">&quot;stdev&quot;</span><span class="p">:</span>
+        <span class="k">return</span> <span class="s2">&quot;StandardDeviation&quot;</span>
+    <span class="k">else</span><span class="p">:</span>
+        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;unknown accumulator - </span><span class="si">{</span><span class="n">acc</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+</code></pre></div></td></tr></table></div>
+          </details>
+  </div>
+
+</div>
+
+
+<div class="doc doc-object doc-function">
+
+
+
 <h4 id="tablite.pivots.pivot" class="doc doc-heading">
 <code class="doc-symbol doc-symbol-heading doc-symbol-function"></code>          <code class="highlight language-python"><span class="n">tablite</span><span class="o">.</span><span class="n">pivots</span><span class="o">.</span><span class="n">pivot</span><span class="p">(</span><span class="n">T</span><span class="p">,</span> <span class="n">rows</span><span class="p">,</span> <span class="n">columns</span><span class="p">,</span> <span class="n">functions</span><span class="p">,</span> <span class="n">values_as_rows</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">tqdm</span><span class="o">=</span><span class="n">_tqdm</span><span class="p">,</span> <span class="n">pbar</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
@@ -1351,21 +1390,7 @@ <h4 id="tablite.pivots.pivot" class="doc doc-heading">
 
           <details class="quote">
             <summary>Source code in <code>tablite/pivots.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 12</span>
-<span class="normal"> 13</span>
-<span class="normal"> 14</span>
-<span class="normal"> 15</span>
-<span class="normal"> 16</span>
-<span class="normal"> 17</span>
-<span class="normal"> 18</span>
-<span class="normal"> 19</span>
-<span class="normal"> 20</span>
-<span class="normal"> 21</span>
-<span class="normal"> 22</span>
-<span class="normal"> 23</span>
-<span class="normal"> 24</span>
-<span class="normal"> 25</span>
-<span class="normal"> 26</span>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 26</span>
 <span class="normal"> 27</span>
 <span class="normal"> 28</span>
 <span class="normal"> 29</span>
@@ -1522,7 +1547,21 @@ <h4 id="tablite.pivots.pivot" class="doc doc-heading">
 <span class="normal">180</span>
 <span class="normal">181</span>
 <span class="normal">182</span>
-<span class="normal">183</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">pivot</span><span class="p">(</span><span class="n">T</span><span class="p">,</span> <span class="n">rows</span><span class="p">,</span> <span class="n">columns</span><span class="p">,</span> <span class="n">functions</span><span class="p">,</span> <span class="n">values_as_rows</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">tqdm</span><span class="o">=</span><span class="n">_tqdm</span><span class="p">,</span> <span class="n">pbar</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+<span class="normal">183</span>
+<span class="normal">184</span>
+<span class="normal">185</span>
+<span class="normal">186</span>
+<span class="normal">187</span>
+<span class="normal">188</span>
+<span class="normal">189</span>
+<span class="normal">190</span>
+<span class="normal">191</span>
+<span class="normal">192</span>
+<span class="normal">193</span>
+<span class="normal">194</span>
+<span class="normal">195</span>
+<span class="normal">196</span>
+<span class="normal">197</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">pivot</span><span class="p">(</span><span class="n">T</span><span class="p">,</span> <span class="n">rows</span><span class="p">,</span> <span class="n">columns</span><span class="p">,</span> <span class="n">functions</span><span class="p">,</span> <span class="n">values_as_rows</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">tqdm</span><span class="o">=</span><span class="n">_tqdm</span><span class="p">,</span> <span class="n">pbar</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    param: rows: column names to keep as rows</span>
 <span class="sd">    param: columns: column names to keep as columns</span>
@@ -1597,7 +1636,7 @@ <h4 id="tablite.pivots.pivot" class="doc doc-heading">
 
         <span class="n">pbar</span> <span class="o">=</span> <span class="n">tqdm</span><span class="p">(</span><span class="n">total</span><span class="o">=</span><span class="n">total</span><span class="p">,</span> <span class="n">desc</span><span class="o">=</span><span class="s2">&quot;pivot&quot;</span><span class="p">)</span>
 
-    <span class="n">grpby</span> <span class="o">=</span> <span class="n">groupby</span><span class="p">(</span><span class="n">T</span><span class="p">,</span> <span class="n">keys</span><span class="p">,</span> <span class="n">functions</span><span class="p">,</span> <span class="n">tqdm</span><span class="o">=</span><span class="n">tqdm</span><span class="p">,</span> <span class="n">pbar</span><span class="o">=</span><span class="n">pbar</span><span class="p">)</span>
+    <span class="n">grpby</span> <span class="o">=</span> <span class="n">groupby</span><span class="p">(</span><span class="n">T</span><span class="p">,</span> <span class="n">keys</span><span class="p">,</span> <span class="n">functions</span><span class="p">,</span> <span class="n">tqdm</span><span class="o">=</span><span class="n">tqdm</span><span class="p">)</span>
     <span class="n">Constr</span> <span class="o">=</span> <span class="nb">type</span><span class="p">(</span><span class="n">T</span><span class="p">)</span>
 
     <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">grpby</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>  <span class="c1"># return empty table. This must be a test?</span>
@@ -1642,7 +1681,7 @@ <h4 id="tablite.pivots.pivot" class="doc doc-heading">
         <span class="n">cols</span> <span class="o">=</span> <span class="p">[[]</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">n</span><span class="p">)]</span>
         <span class="k">for</span> <span class="n">row</span><span class="p">,</span> <span class="n">ix</span> <span class="ow">in</span> <span class="n">row_key_index</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
             <span class="k">for</span> <span class="n">col_name</span><span class="p">,</span> <span class="n">f</span> <span class="ow">in</span> <span class="n">functions</span><span class="p">:</span>
-                <span class="n">cols</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">f</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">(</span><span class="si">{</span><span class="n">col_name</span><span class="si">}</span><span class="s2">)&quot;</span><span class="p">)</span>
+                <span class="n">cols</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">acc2Name</span><span class="p">(</span><span class="n">f</span><span class="p">)</span><span class="si">}</span><span class="s2">(</span><span class="si">{</span><span class="n">col_name</span><span class="si">}</span><span class="s2">)&quot;</span><span class="p">)</span>
                 <span class="k">for</span> <span class="n">col_ix</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">row</span><span class="p">):</span>
                     <span class="n">cols</span><span class="p">[</span><span class="n">col_ix</span><span class="p">]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">v</span><span class="p">)</span>
 
@@ -1681,7 +1720,7 @@ <h4 id="tablite.pivots.pivot" class="doc doc-heading">
             <span class="k">for</span> <span class="n">f</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span><span class="n">functions</span><span class="p">,</span> <span class="n">func_key</span><span class="p">):</span>
                 <span class="n">agg_col</span><span class="p">,</span> <span class="n">func</span> <span class="o">=</span> <span class="n">f</span>
                 <span class="n">terms</span> <span class="o">=</span> <span class="s2">&quot;,&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">([</span><span class="n">agg_col</span><span class="p">]</span> <span class="o">+</span> <span class="p">[</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">col_name</span><span class="si">}</span><span class="s2">=</span><span class="si">{</span><span class="n">value</span><span class="si">}</span><span class="s2">&quot;</span> <span class="k">for</span> <span class="n">col_name</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span><span class="n">columns</span><span class="p">,</span> <span class="n">col_key</span><span class="p">)])</span>
-                <span class="n">col_name</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">func</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">(</span><span class="si">{</span><span class="n">terms</span><span class="si">}</span><span class="s2">)&quot;</span>
+                <span class="n">col_name</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">acc2Name</span><span class="p">(</span><span class="n">func</span><span class="p">)</span><span class="si">}</span><span class="s2">(</span><span class="si">{</span><span class="n">terms</span><span class="si">}</span><span class="s2">)&quot;</span>
                 <span class="n">col_name</span> <span class="o">=</span> <span class="n">unique_name</span><span class="p">(</span><span class="n">col_name</span><span class="p">,</span> <span class="n">result</span><span class="o">.</span><span class="n">columns</span><span class="p">)</span>
                 <span class="n">names</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">col_name</span><span class="p">)</span>
                 <span class="n">cols</span><span class="o">.</span><span class="n">append</span><span class="p">([</span><span class="kc">None</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">col_length</span><span class="p">)])</span>
@@ -1717,20 +1756,20 @@ <h4 id="tablite.pivots.transpose" class="doc doc-heading">
 
           <details class="quote">
             <summary>Source code in <code>tablite/pivots.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">186</span>
-<span class="normal">187</span>
-<span class="normal">188</span>
-<span class="normal">189</span>
-<span class="normal">190</span>
-<span class="normal">191</span>
-<span class="normal">192</span>
-<span class="normal">193</span>
-<span class="normal">194</span>
-<span class="normal">195</span>
-<span class="normal">196</span>
-<span class="normal">197</span>
-<span class="normal">198</span>
-<span class="normal">199</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">transpose</span><span class="p">(</span><span class="n">T</span><span class="p">,</span> <span class="n">tqdm</span><span class="o">=</span><span class="n">_tqdm</span><span class="p">):</span>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">200</span>
+<span class="normal">201</span>
+<span class="normal">202</span>
+<span class="normal">203</span>
+<span class="normal">204</span>
+<span class="normal">205</span>
+<span class="normal">206</span>
+<span class="normal">207</span>
+<span class="normal">208</span>
+<span class="normal">209</span>
+<span class="normal">210</span>
+<span class="normal">211</span>
+<span class="normal">212</span>
+<span class="normal">213</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">transpose</span><span class="p">(</span><span class="n">T</span><span class="p">,</span> <span class="n">tqdm</span><span class="o">=</span><span class="n">_tqdm</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;performs a CCW matrix rotation of the table.&quot;&quot;&quot;</span>
     <span class="n">sub_cls_check</span><span class="p">(</span><span class="n">T</span><span class="p">,</span> <span class="n">BaseTable</span><span class="p">)</span>
 
@@ -1855,21 +1894,7 @@ <h4 id="tablite.pivots.pivot_transpose" class="doc doc-heading">
 
           <details class="quote">
             <summary>Source code in <code>tablite/pivots.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">202</span>
-<span class="normal">203</span>
-<span class="normal">204</span>
-<span class="normal">205</span>
-<span class="normal">206</span>
-<span class="normal">207</span>
-<span class="normal">208</span>
-<span class="normal">209</span>
-<span class="normal">210</span>
-<span class="normal">211</span>
-<span class="normal">212</span>
-<span class="normal">213</span>
-<span class="normal">214</span>
-<span class="normal">215</span>
-<span class="normal">216</span>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">216</span>
 <span class="normal">217</span>
 <span class="normal">218</span>
 <span class="normal">219</span>
@@ -1942,7 +1967,21 @@ <h4 id="tablite.pivots.pivot_transpose" class="doc doc-heading">
 <span class="normal">286</span>
 <span class="normal">287</span>
 <span class="normal">288</span>
-<span class="normal">289</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">pivot_transpose</span><span class="p">(</span><span class="n">T</span><span class="p">,</span> <span class="n">columns</span><span class="p">,</span> <span class="n">keep</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">column_name</span><span class="o">=</span><span class="s2">&quot;transpose&quot;</span><span class="p">,</span> <span class="n">value_name</span><span class="o">=</span><span class="s2">&quot;value&quot;</span><span class="p">,</span> <span class="n">tqdm</span><span class="o">=</span><span class="n">_tqdm</span><span class="p">):</span>
+<span class="normal">289</span>
+<span class="normal">290</span>
+<span class="normal">291</span>
+<span class="normal">292</span>
+<span class="normal">293</span>
+<span class="normal">294</span>
+<span class="normal">295</span>
+<span class="normal">296</span>
+<span class="normal">297</span>
+<span class="normal">298</span>
+<span class="normal">299</span>
+<span class="normal">300</span>
+<span class="normal">301</span>
+<span class="normal">302</span>
+<span class="normal">303</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span> <span class="nf">pivot_transpose</span><span class="p">(</span><span class="n">T</span><span class="p">,</span> <span class="n">columns</span><span class="p">,</span> <span class="n">keep</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">column_name</span><span class="o">=</span><span class="s2">&quot;transpose&quot;</span><span class="p">,</span> <span class="n">value_name</span><span class="o">=</span><span class="s2">&quot;value&quot;</span><span class="p">,</span> <span class="n">tqdm</span><span class="o">=</span><span class="n">_tqdm</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;Transpose a selection of columns to rows.</span>
 
 <span class="sd">    Args:</span>
diff --git a/master/reference/redux/index.html b/master/reference/redux/index.html
index ba210c5e..1d59f8a4 100644
--- a/master/reference/redux/index.html
+++ b/master/reference/redux/index.html
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -707,27 +705,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
diff --git a/master/reference/reindex/index.html b/master/reference/reindex/index.html
index 17b56b47..c3fc1db6 100644
--- a/master/reference/reindex/index.html
+++ b/master/reference/reindex/index.html
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -707,27 +705,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
diff --git a/master/reference/sort_utils/index.html b/master/reference/sort_utils/index.html
index de1e9dc5..00325657 100644
--- a/master/reference/sort_utils/index.html
+++ b/master/reference/sort_utils/index.html
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -707,27 +705,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
diff --git a/master/reference/sortation/index.html b/master/reference/sortation/index.html
index 60b3e567..d0e1e801 100644
--- a/master/reference/sortation/index.html
+++ b/master/reference/sortation/index.html
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -707,27 +705,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
diff --git a/master/reference/tools/index.html b/master/reference/tools/index.html
index 4e480165..ae308412 100644
--- a/master/reference/tools/index.html
+++ b/master/reference/tools/index.html
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -707,27 +705,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
diff --git a/master/reference/utils/index.html b/master/reference/utils/index.html
index 4875d3e7..14da0995 100644
--- a/master/reference/utils/index.html
+++ b/master/reference/utils/index.html
@@ -473,8 +473,6 @@
         
       
         
-      
-        
       
         
       
@@ -707,27 +705,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
diff --git a/master/reference/version/index.html b/master/reference/version/index.html
index 5919e846..f7451a0b 100644
--- a/master/reference/version/index.html
+++ b/master/reference/version/index.html
@@ -471,8 +471,6 @@
         
       
         
-      
-        
       
         
       
@@ -705,27 +703,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../import_utils/" class="md-nav__link">
         
diff --git a/master/search/search_index.json b/master/search/search_index.json
index a6ee5820..4ebd5d4b 100644
--- a/master/search/search_index.json
+++ b/master/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Tablite","text":""},{"location":"#contents","title":"Contents","text":"<ul> <li>introduction</li> <li>installation</li> <li>feature overview</li> <li>api</li> <li>tutorial</li> <li>latest updates</li> <li>credits</li> </ul>"},{"location":"#introduction","title":"Introduction","text":"<p><code>Tablite</code> seeks to be the go-to library for manipulating tabular data with an api that is as close in syntax to pure python as possible. </p>"},{"location":"#even-smaller-memory-footprint","title":"Even smaller memory footprint","text":"<p>Tablite uses numpys fileformat as a backend with strong abstraction, so that copy, append &amp; repetition of data is handled in pages. This is imperative for incremental data processing.</p> <p>Tablite tests for memory footprint. One test compares the memory footprint of 10,000,000 integers where <code>tablite</code> will use &lt; 1 Mb RAM in contrast to python which will require around 133.7 Mb of RAM (1M lists with 10 integers). Tablite also tests to assure that working with 1Tb of data is tolerable.</p> <p>Tablite achieves this minimal memory footprint by using a temporary storage set in <code>config.Config.workdir</code> as <code>tempfile.gettempdir()/tablite-tmp</code>. If your OS (windows/linux/mac) sits on a SSD this will benefit from high IOPS and permit slices of 9,000,000,000 rows in less than a second.</p>"},{"location":"#multiprocessing-enabled-by-default","title":"Multiprocessing enabled by default","text":"<p>Tablite uses numpy whereever possible and applies multiprocessing for bypassing the GIL on all major operations.  CSV import is performed in C through using <code>nim</code>s compiler and is as fast the hardware allows.</p>"},{"location":"#all-algorithms-have-been-reworked-to-respect-memory-limits","title":"All algorithms have been reworked to respect memory limits","text":"<p>Tablite respects the limits of free memory by tagging the free memory and defining task size before each memory intensive task is initiated (join, groupby, data import, etc). If you still run out of memory you may try to reduce the <code>config.Config.PAGE_SIZE</code> and rerun your program.</p>"},{"location":"#100-support-for-all-python-datatypes","title":"100% support for all python datatypes","text":"<p>Tablite wants to make it easy for you to work with data. <code>tablite.Table's</code> behave like a dict with lists:</p> <p><code>my_table[column name] = [... data ...]</code>.</p> <p>Tablite uses datatype mapping to native numpy types where possible and uses type mapping for non-native types such as timedelta, None, date, time\u2026 e.g. what you put in, is what you get out. This is inspired by bank python.</p>"},{"location":"#light-weight","title":"Light weight","text":"<p>Tablite is ~200 kB.</p>"},{"location":"#helpful","title":"Helpful","text":"<p>Tablite wants you to be productive, so a number of helpers are available. </p> <ul> <li><code>Table.import_file</code> to import csv*, tsv, txt, xls, xlsx, xlsm, ods, zip and logs. There is automatic type detection (see tutorial.ipynb )</li> <li>To peek into any supported file use <code>get_headers</code> which shows the first 10 rows.</li> <li>Use <code>mytable.rows</code> and <code>mytable.columns</code> to iterate over rows or columns.</li> <li>Create multi-key <code>.index</code> for quick lookups.</li> <li>Perform multi-key <code>.sort</code>,</li> <li>Filter using <code>.any</code> and <code>.all</code> to select specific rows.</li> <li>use multi-key <code>.lookup</code> and <code>.join</code> to find data across tables.</li> <li>Perform <code>.groupby</code> and reorganise data as a <code>.pivot</code> table with max, min, sum, first, last, count, unique, average, st.deviation, median and mode</li> <li>Append / concatenate tables with <code>+=</code> which automatically sorts out the columns - even if they're not in perfect order.</li> <li>Should you tables be similar but not the identical you can use <code>.stack</code> to \"stack\" tables on top of each other</li> </ul> <p>If you're still missing something add it to the wishlist</p>"},{"location":"#installation","title":"Installation","text":"<p>Get it from pypi: </p> <p>Install: <code>pip install tablite</code> Usage:  <code>&gt;&gt;&gt; from tablite import Table</code> </p>"},{"location":"#build-test","title":"Build &amp; test","text":"<p>install nim &gt;= 2.0.0</p> <p>run: <code>chmod +x ./build_nim.sh</code> run: <code>./build_nim.sh</code></p> <p>Should the default nim not be your desired taste, please use <code>nims</code> environment manager (<code>atlas</code>) and run <code>source nim-2.0.0/activate.sh</code> on UNIX or <code>nim-2.0.0/activate.bat</code> on windows.</p> <pre><code>install python &gt;= 3.8\npython -m venv /your/venv/dir\nactivate /your/venv/dir\npip install -r requirements.txt\npip install -r requirements_for_testing.py\npytest ./tests\n</code></pre>"},{"location":"#feature-overview","title":"Feature overview","text":"want to... this way... loop over rows <code>[ row for row in table.rows ]</code> loop over columns <code>[ table[col_name] for col_name in table.columns ]</code> slice <code>myslice = table['A', 'B', slice(0,None,15)]</code> get column by name <code>my_table['A']</code> get row by index <code>my_table[9_000_000_001]</code> value update <code>mytable['A'][2] = new value</code> update w. list comprehension <code>mytable['A'] = [ x*x for x in mytable['A'] if x % 2 != 0 ]</code> join <code>a_join = numbers.join(letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter'], kind='left')</code> lookup <code>travel_plan = friends.lookup(bustable, (DataTypes.time(21, 10), \"&lt;=\", 'time'), ('stop', \"==\", 'stop'))</code> groupby <code>group_by = table.groupby(keys=['C', 'B'], functions=[('A', gb.count)])</code> pivot table <code>my_pivot = t.pivot(rows=['C'], columns=['A'], functions=[('B', gb.sum), ('B', gb.count)], values_as_rows=False)</code> index <code>indices = old_table.index(*old_table.columns)</code> sort <code>lookup1_sorted = lookup_1.sort(**{'time': True, 'name':False, \"sort_mode\":'unix'})</code> filter <code>true, false = unfiltered.filter( [{\"column1\": 'a', \"criteria\":\"&gt;=\", 'value2':3}, ... more criteria ... ], filter_type='all' )</code> find any <code>any_even_rows = mytable.any('A': lambda x : x%2==0, 'B': lambda x &gt; 0)</code> find all <code>all_even_rows = mytable.all('A': lambda x : x%2==0, 'B': lambda x &gt; 0)</code> to json <code>json_str = my_table.to_json()</code> from json <code>Table.from_json(json_str)</code>"},{"location":"#api","title":"API","text":"<p>To view the detailed API see api</p>"},{"location":"#tutorial","title":"Tutorial","text":"<p>To learn more see the tutorial.ipynb (Jupyter notebook)</p>"},{"location":"#latest-updates","title":"Latest updates","text":"<p>See changelog.md</p>"},{"location":"#credits","title":"Credits","text":"<ul> <li>Eugene Antonov - the api documentation.</li> <li>Audrius Kulikajevas - Edge case testing / various bugs, Jupyter notebook integration.</li> <li>Ovidijus Grigas - various bugs, documentation.</li> <li>Martynas Kaunas - GroupBy functionality.</li> <li>Sergej Sinkarenko - various bugs.</li> <li>Lori Cooper - spell checking.</li> </ul>"},{"location":"benchmarks/","title":"Benchmarks","text":"In\u00a0[2]: Copied! <pre>import psutil, os, gc, shutil, tempfile\nfrom pathlib import Path\nfrom time import perf_counter, time\nfrom tablite import Table\nfrom tablite.datasets import synthetic_order_data\nfrom tablite.config import Config\n\nConfig.TQDM_DISABLE = True\n</pre> import psutil, os, gc, shutil, tempfile from pathlib import Path from time import perf_counter, time from tablite import Table from tablite.datasets import synthetic_order_data from tablite.config import Config  Config.TQDM_DISABLE = True In\u00a0[3]: Copied! <pre>process = psutil.Process(os.getpid())\n\ndef make_tables(sizes=[1,2,5,10,20,50]):\n    # The last tables are too big for RAM (~24Gb), so I create subtables of 1M rows and append them.\n    t = synthetic_order_data(Config.PAGE_SIZE)\n    real, flat = t.nbytes()\n    print(f\"Table {len(t):,} rows is {real/1e6:,.0f} Mb on disk\")\n\n    tables = [t]  # 1M rows.\n\n    last = 1\n    t2 = t.copy()\n    for i in sizes[1:]:\n        t2 = t2.copy()\n        for _ in range(i-last):\n            t2 += synthetic_order_data(Config.PAGE_SIZE)  # these are all unique\n        last = i\n        real, flat = t2.nbytes()\n        tables.append(t2)\n        print(f\"Table {len(t2):,} rows is {real/1e6:,.0f} Mb on disk\")\n    return tables\n\ntables = make_tables()\n</pre> process = psutil.Process(os.getpid())  def make_tables(sizes=[1,2,5,10,20,50]):     # The last tables are too big for RAM (~24Gb), so I create subtables of 1M rows and append them.     t = synthetic_order_data(Config.PAGE_SIZE)     real, flat = t.nbytes()     print(f\"Table {len(t):,} rows is {real/1e6:,.0f} Mb on disk\")      tables = [t]  # 1M rows.      last = 1     t2 = t.copy()     for i in sizes[1:]:         t2 = t2.copy()         for _ in range(i-last):             t2 += synthetic_order_data(Config.PAGE_SIZE)  # these are all unique         last = i         real, flat = t2.nbytes()         tables.append(t2)         print(f\"Table {len(t2):,} rows is {real/1e6:,.0f} Mb on disk\")     return tables  tables = make_tables() <pre>Table 1,000,000 rows is 256 Mb on disk\nTable 2,000,000 rows is 512 Mb on disk\nTable 5,000,000 rows is 1,280 Mb on disk\nTable 10,000,000 rows is 2,560 Mb on disk\nTable 20,000,000 rows is 5,120 Mb on disk\nTable 50,000,000 rows is 12,800 Mb on disk\n</pre> <p>The values in the tables above are all unique!</p> In\u00a0[4]: Copied! <pre>tables[-1]\n</pre> tables[-1] Out[4]: ~#1234567891011         0114014953182952021-10-06T00:00:0050814119375C3-4HGQ21\u00b0XYZ1.244647268201734421.367107051830455         129320231372182021-08-26T00:00:005007718568C5-5FZU0\u00b00.55294485347516132.6980406874392537         2312569602250812021-12-21T00:00:0050197029074C2-3GTK6\u00b0XYZ1.99739754559065617.513164305723787         3414012777817432021-08-23T00:00:0050818024969C4-3BYP6\u00b0XYZ0.047497125538289577.388171617130485         459426667674262021-07-31T00:00:0050307113074C5-2CCC21\u00b0ABC1.0219215027612885.21324123446987         5612186131851272021-12-01T00:00:0050484117249C5-4WGT21\u00b00.2038764258434556712.190974436133764         676070424343982021-11-29T00:00:0050578011564C2-3LUL0\u00b0XYZ2.2367835158480444.340628097363572.......................................49,999,9939999946602693775472021-09-17T00:00:005015409706C4-3AHQ21\u00b0XYZ0.083216645843125856.56780297752790549,999,9949999955709798646952021-08-01T00:00:0050149125006C1-2FWH6\u00b01.04763923662266419.50710544462706549,999,9959999963551956078252021-07-29T00:00:0050007026992C4-3GVG21\u00b02.20440816560941411.2706443974284949,999,99699999720762240577282021-10-16T00:00:0050950113339C5-4NKS0\u00b02.1593110498135494.21575620046596149,999,9979999986577247891352021-12-21T00:00:0050069114747C2-4LYGNone1.64809640191698683.094420483625827349,999,9989999999775312438842021-12-02T00:00:0050644129345C2-5DRH6\u00b02.30911421692753110.82706867207146849,999,999100000012290713920652021-08-23T00:00:0050706119732C4-5AGB6\u00b00.488871405593691630.8580085696389939 In\u00a0[5]: Copied! <pre>def save_load_benchmarks(tables):\n    tmp = Path(tempfile.gettempdir()) / \"junk\"\n    tmp.mkdir(exist_ok=True)\n\n    results = Table()\n    results.add_columns('rows', 'save (sec)', 'load (sec)')\n    for t in tables:\n        fn = tmp / f'{len(t)}.tpz'\n        start = perf_counter()\n        t.save(fn)\n        end = perf_counter()\n        save = round(end-start,3)\n        assert fn.exists()\n        \n        \n        start = perf_counter()\n        t2 = Table.load(fn)\n        end = perf_counter()\n        load = round(end-start,3)\n        print(f\"saving {len(t):,} rows ({fn.stat().st_size/1e6:,.0f} Mb) took {save:,.3f} seconds. loading took {load:,.3f} seconds\")\n        del t2\n        fn.unlink()\n        results.add_rows(len(t), save, load)\n    \n    r = results\n    r['save r/sec'] = [int(a/b) if b!=0  else \"nil\" for a,b in zip(r['rows'], r['save (sec)']) ]\n    r['load r/sec'] = [int(a/b) if b!=0  else \"nil\" for a,b in zip(r['rows'], r['load (sec)'])]\n\n    return results\n</pre> def save_load_benchmarks(tables):     tmp = Path(tempfile.gettempdir()) / \"junk\"     tmp.mkdir(exist_ok=True)      results = Table()     results.add_columns('rows', 'save (sec)', 'load (sec)')     for t in tables:         fn = tmp / f'{len(t)}.tpz'         start = perf_counter()         t.save(fn)         end = perf_counter()         save = round(end-start,3)         assert fn.exists()                           start = perf_counter()         t2 = Table.load(fn)         end = perf_counter()         load = round(end-start,3)         print(f\"saving {len(t):,} rows ({fn.stat().st_size/1e6:,.0f} Mb) took {save:,.3f} seconds. loading took {load:,.3f} seconds\")         del t2         fn.unlink()         results.add_rows(len(t), save, load)          r = results     r['save r/sec'] = [int(a/b) if b!=0  else \"nil\" for a,b in zip(r['rows'], r['save (sec)']) ]     r['load r/sec'] = [int(a/b) if b!=0  else \"nil\" for a,b in zip(r['rows'], r['load (sec)'])]      return results  In\u00a0[6]: Copied! <pre>slb = save_load_benchmarks(tables)\n</pre> slb = save_load_benchmarks(tables) <pre>saving 1,000,000 rows (49 Mb) took 2.148 seconds. loading took 0.922 seconds\nsaving 2,000,000 rows (98 Mb) took 4.267 seconds. loading took 1.820 seconds\nsaving 5,000,000 rows (246 Mb) took 10.618 seconds. loading took 4.482 seconds\nsaving 10,000,000 rows (492 Mb) took 21.291 seconds. loading took 8.944 seconds\nsaving 20,000,000 rows (984 Mb) took 42.603 seconds. loading took 17.821 seconds\nsaving 50,000,000 rows (2,461 Mb) took 106.644 seconds. loading took 44.600 seconds\n</pre> In\u00a0[7]: Copied! <pre>slb\n</pre> slb Out[7]: #rowssave (sec)load (sec)save r/secload r/sec 010000002.1480.9224655491084598 120000004.2671.824687131098901 2500000010.6184.4824708981115573 31000000021.2918.9444696821118067 42000000042.60317.8214694501122271 550000000106.64444.64688491121076 <p>With various compression options</p> In\u00a0[8]: Copied! <pre>def save_compression_benchmarks(t):\n    tmp = Path(tempfile.gettempdir()) / \"junk\"\n    tmp.mkdir(exist_ok=True)\n\n    import zipfile  # https://docs.python.org/3/library/zipfile.html#zipfile.ZipFile\n    methods = [(None, zipfile.ZIP_STORED, \"zip stored\"), (None, zipfile.ZIP_LZMA, \"zip lzma\")]\n    methods += [(i, zipfile.ZIP_DEFLATED, \"zip deflated\") for i in range(0,10)]\n    methods += [(i, zipfile.ZIP_BZIP2, \"zip bzip2\") for i in range(1,10)]\n\n    results = Table()\n    results.add_columns('file size (Mb)', 'method', 'write (sec)', 'read (sec)')\n    for level, method, name in methods:\n        fn = tmp / f'{len(t)}.tpz'\n        start = perf_counter()  \n        t.save(fn, compression_method=method, compression_level=level)\n        end = perf_counter()\n        write = round(end-start,3)\n        assert fn.exists()\n        size = int(fn.stat().st_size/1e6)\n        # print(f\"{name}(level={level}): {len(t):,} rows ({size} Mb) took {write:,.3f} secconds to save\", end='')\n        \n        start = perf_counter()\n        t2 = Table.load(fn)\n        end = perf_counter()\n        read = round(end-start,3)\n        # print(f\" and {end-start:,.3} seconds to load\")\n        print(\".\", end='')\n        \n        del t2\n        fn.unlink()\n        results.add_rows(size, f\"{name}(level={level})\", write, read)\n        \n    \n    r = results\n    r.sort({'write (sec)':True})\n    r['write (rps)'] = [int(1_000_000/b) for b in r['write (sec)']]\n    r['read (rps)'] = [int(1_000_000/b) for b in r['read (sec)']]\n    return results\n</pre> def save_compression_benchmarks(t):     tmp = Path(tempfile.gettempdir()) / \"junk\"     tmp.mkdir(exist_ok=True)      import zipfile  # https://docs.python.org/3/library/zipfile.html#zipfile.ZipFile     methods = [(None, zipfile.ZIP_STORED, \"zip stored\"), (None, zipfile.ZIP_LZMA, \"zip lzma\")]     methods += [(i, zipfile.ZIP_DEFLATED, \"zip deflated\") for i in range(0,10)]     methods += [(i, zipfile.ZIP_BZIP2, \"zip bzip2\") for i in range(1,10)]      results = Table()     results.add_columns('file size (Mb)', 'method', 'write (sec)', 'read (sec)')     for level, method, name in methods:         fn = tmp / f'{len(t)}.tpz'         start = perf_counter()           t.save(fn, compression_method=method, compression_level=level)         end = perf_counter()         write = round(end-start,3)         assert fn.exists()         size = int(fn.stat().st_size/1e6)         # print(f\"{name}(level={level}): {len(t):,} rows ({size} Mb) took {write:,.3f} secconds to save\", end='')                  start = perf_counter()         t2 = Table.load(fn)         end = perf_counter()         read = round(end-start,3)         # print(f\" and {end-start:,.3} seconds to load\")         print(\".\", end='')                  del t2         fn.unlink()         results.add_rows(size, f\"{name}(level={level})\", write, read)                   r = results     r.sort({'write (sec)':True})     r['write (rps)'] = [int(1_000_000/b) for b in r['write (sec)']]     r['read (rps)'] = [int(1_000_000/b) for b in r['read (sec)']]     return results In\u00a0[9]: Copied! <pre>scb = save_compression_benchmarks(tables[0])\n</pre> scb = save_compression_benchmarks(tables[0]) <pre>.....................</pre> <pre>creating sort index:   0%|          | 0/1 [00:00&lt;?, ?it/s]\rcreating sort index: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 1/1 [00:00&lt;00:00, 268.92it/s]\n</pre> In\u00a0[10]: Copied! <pre>scb[0:20]\n</pre> scb[0:20] Out[10]: #file size (Mb)methodwrite (sec)read (sec)write (rps)read (rps) 0256zip stored(level=None)0.3960.47525252522105263 129zip lzma(level=None)95.1372.22810511448833 2256zip deflated(level=0)0.5350.59518691581680672 349zip deflated(level=1)2.150.9224651161084598 447zip deflated(level=2)2.2640.9124416961096491 543zip deflated(level=3)3.0490.833279761204819 644zip deflated(level=4)2.920.8623424651160092 742zip deflated(level=5)4.0340.8692478921150747 840zip deflated(level=6)8.5580.81168491250000 939zip deflated(level=7)13.6950.7787301912853471038zip deflated(level=8)56.9720.7921755212626261138zip deflated(level=9)122.6230.791815512642221229zip bzip2(level=1)15.1214.065661332460021329zip bzip2(level=2)16.0474.214623162373041429zip bzip2(level=3)16.8584.409593192268081529zip bzip2(level=4)17.6485.141566631945141629zip bzip2(level=5)18.6746.009535501664171729zip bzip2(level=6)19.4056.628515331508751829zip bzip2(level=7)19.9546.714501151489421929zip bzip2(level=8)20.5956.96148555143657 <p>Conclusions</p> <ul> <li>Fastest: zip stored with no compression takes handles</li> </ul> In\u00a0[11]: Copied! <pre>def to_sql_benchmark(t, rows=1_000_000):\n    t2 = t[:rows]\n    write_start = time()\n    _ = t2.to_sql(name='1')\n    write_end = time()\n    write = round(write_end-write_start,3)\n    return ( t.to_sql.__name__, write, 0, len(t2), \"\" , \"\" )\n</pre> def to_sql_benchmark(t, rows=1_000_000):     t2 = t[:rows]     write_start = time()     _ = t2.to_sql(name='1')     write_end = time()     write = round(write_end-write_start,3)     return ( t.to_sql.__name__, write, 0, len(t2), \"\" , \"\" )  In\u00a0[12]: Copied! <pre>def to_json_benchmark(t, rows=1_000_000):\n    t2 = t[:rows]\n\n    tmp = Path(tempfile.gettempdir()) / \"junk\"\n    tmp.mkdir(exist_ok=True)\n    path = tmp / \"1.json\" \n    \n    write_start = time()\n    bytestr = t2.to_json()\n    with path.open('w') as fo:\n        fo.write(bytestr)\n    write_end = time()\n    write = round(write_end-write_start,3)\n\n    read_start = time()\n    with path.open('r') as fi:\n        _ = Table.from_json(fi.read())  # &lt;-- JSON\n    read_end = time()\n    read = round(read_end-read_start,3)\n\n    return ( t.to_json.__name__, write, read, len(t2), int(path.stat().st_size/1e6), \"\" )\n</pre> def to_json_benchmark(t, rows=1_000_000):     t2 = t[:rows]      tmp = Path(tempfile.gettempdir()) / \"junk\"     tmp.mkdir(exist_ok=True)     path = tmp / \"1.json\"           write_start = time()     bytestr = t2.to_json()     with path.open('w') as fo:         fo.write(bytestr)     write_end = time()     write = round(write_end-write_start,3)      read_start = time()     with path.open('r') as fi:         _ = Table.from_json(fi.read())  # &lt;-- JSON     read_end = time()     read = round(read_end-read_start,3)      return ( t.to_json.__name__, write, read, len(t2), int(path.stat().st_size/1e6), \"\" )  In\u00a0[13]: Copied! <pre>def f(t, args):\n    rows, c1, c1_kw, c2, c2_kw = args\n    t2 = t[:rows]\n\n    call = getattr(t2, c1)\n    assert callable(call)\n\n    write_start = time()\n    call(**c1_kw)\n    write_end = time()\n    write = round(write_end-write_start,3)\n\n    for _ in range(10):\n        gc.collect()\n\n    read_start = time()\n    if callable(c2):\n        c2(**c2_kw)\n    read_end = time()\n    read = round(read_end-read_start,3)\n\n    fn = c2_kw['path']\n    assert fn.exists()\n    fs = int(fn.stat().st_size/1e6)\n    config = {k:v for k,v in c2_kw.items() if k!= 'path'}\n\n    return ( c1, write, read, len(t2), fs , str(config))\n</pre> def f(t, args):     rows, c1, c1_kw, c2, c2_kw = args     t2 = t[:rows]      call = getattr(t2, c1)     assert callable(call)      write_start = time()     call(**c1_kw)     write_end = time()     write = round(write_end-write_start,3)      for _ in range(10):         gc.collect()      read_start = time()     if callable(c2):         c2(**c2_kw)     read_end = time()     read = round(read_end-read_start,3)      fn = c2_kw['path']     assert fn.exists()     fs = int(fn.stat().st_size/1e6)     config = {k:v for k,v in c2_kw.items() if k!= 'path'}      return ( c1, write, read, len(t2), fs , str(config))  In\u00a0[14]: Copied! <pre>def import_export_benchmarks(tables):\n    Config.PROCESSING_MODE = Config.FALSE\n        \n    t = sorted(tables, key=lambda x: len(x), reverse=True)[0]\n    \n    tmp = Path(tempfile.gettempdir()) / \"junk\"\n    tmp.mkdir(exist_ok=True)   \n\n    args = [\n        (   100_000, \"to_xlsx\", {'path': tmp/'1.xlsx'}, Table.from_file, {\"path\":tmp/'1.xlsx', \"sheet\":\"pyexcel_sheet1\"}),\n        (    50_000,  \"to_ods\",  {'path': tmp/'1.ods'}, Table.from_file, {\"path\":tmp/'1.ods', \"sheet\":\"pyexcel_sheet1\"} ),  # 50k rows, otherwise MemoryError.\n        ( 1_000_000,  \"to_csv\",  {'path': tmp/'1.csv'}, Table.from_file, {\"path\":tmp/'1.csv'}                           ),\n        ( 1_000_000,  \"to_csv\",  {'path': tmp/'1.csv'}, Table.from_file, {\"path\":tmp/'1.csv', \"guess_datatypes\":False}),\n        (10_000_000,  \"to_csv\",  {'path': tmp/'1.csv'}, Table.from_file, {\"path\":tmp/'1.csv', \"guess_datatypes\":False}),\n        ( 1_000_000,  \"to_tsv\",  {'path': tmp/'1.tsv'}, Table.from_file, {\"path\":tmp/'1.tsv'}                           ),\n        ( 1_000_000, \"to_text\",  {'path': tmp/'1.txt'}, Table.from_file, {\"path\":tmp/'1.txt'}                           ),\n        ( 1_000_000, \"to_html\", {'path': tmp/'1.html'}, Table.from_file, {\"path\":tmp/'1.html'}                          ),\n        ( 1_000_000, \"to_hdf5\", {'path': tmp/'1.hdf5'}, Table.from_file, {\"path\":tmp/'1.hdf5'}                          )\n    ]\n\n    results = Table()\n    results.add_columns('method', 'write (s)', 'read (s)', 'rows', 'size (Mb)', 'config')\n\n    results.add_rows( to_sql_benchmark(t) )\n    results.add_rows( to_json_benchmark(t) )\n\n    for arg in args:\n        if len(t)&lt;arg[0]:\n            continue\n        print(\".\", end='')\n        try:\n            results.add_rows( f(t, arg) )\n        except MemoryError:\n            results.add_rows( arg[1], \"Memory Error\", \"NIL\", args[0], \"NIL\", \"N/A\")\n    \n    r = results\n    r['read r/sec'] = [int(a/b) if b!=0  else \"nil\" for a,b in zip(r['rows'], r['read (s)']) ]\n    r['write r/sec'] = [int(a/b) if b!=0  else \"nil\" for a,b in zip(r['rows'], r['write (s)'])]\n\n    shutil.rmtree(tmp)\n    return results\n</pre> def import_export_benchmarks(tables):     Config.PROCESSING_MODE = Config.FALSE              t = sorted(tables, key=lambda x: len(x), reverse=True)[0]          tmp = Path(tempfile.gettempdir()) / \"junk\"     tmp.mkdir(exist_ok=True)         args = [         (   100_000, \"to_xlsx\", {'path': tmp/'1.xlsx'}, Table.from_file, {\"path\":tmp/'1.xlsx', \"sheet\":\"pyexcel_sheet1\"}),         (    50_000,  \"to_ods\",  {'path': tmp/'1.ods'}, Table.from_file, {\"path\":tmp/'1.ods', \"sheet\":\"pyexcel_sheet1\"} ),  # 50k rows, otherwise MemoryError.         ( 1_000_000,  \"to_csv\",  {'path': tmp/'1.csv'}, Table.from_file, {\"path\":tmp/'1.csv'}                           ),         ( 1_000_000,  \"to_csv\",  {'path': tmp/'1.csv'}, Table.from_file, {\"path\":tmp/'1.csv', \"guess_datatypes\":False}),         (10_000_000,  \"to_csv\",  {'path': tmp/'1.csv'}, Table.from_file, {\"path\":tmp/'1.csv', \"guess_datatypes\":False}),         ( 1_000_000,  \"to_tsv\",  {'path': tmp/'1.tsv'}, Table.from_file, {\"path\":tmp/'1.tsv'}                           ),         ( 1_000_000, \"to_text\",  {'path': tmp/'1.txt'}, Table.from_file, {\"path\":tmp/'1.txt'}                           ),         ( 1_000_000, \"to_html\", {'path': tmp/'1.html'}, Table.from_file, {\"path\":tmp/'1.html'}                          ),         ( 1_000_000, \"to_hdf5\", {'path': tmp/'1.hdf5'}, Table.from_file, {\"path\":tmp/'1.hdf5'}                          )     ]      results = Table()     results.add_columns('method', 'write (s)', 'read (s)', 'rows', 'size (Mb)', 'config')      results.add_rows( to_sql_benchmark(t) )     results.add_rows( to_json_benchmark(t) )      for arg in args:         if len(t) In\u00a0[15]: Copied! <pre>ieb = import_export_benchmarks(tables)\n</pre> ieb = import_export_benchmarks(tables) <pre>.........writing 12,000,000 records to /tmp/junk/1.hdf5... done\n</pre> In\u00a0[16]: Copied! <pre>ieb\n</pre> ieb Out[16]: #methodwrite (s)read (s)rowssize (Mb)configread r/secwrite r/sec 0to_sql12.34501000000nil81004 1to_json10.8144.406100000014222696392472 2to_xlsx10.56921.5721000009{'sheet': 'pyexcel_sheet1'}46359461 3to_ods29.17529.487500003{'sheet': 'pyexcel_sheet1'}16951713 4to_csv14.31515.7311000000108{}6356869856 5to_csv14.4388.1691000000108{'guess_datatypes': False}12241469261 6to_csv140.64599.45100000001080{'guess_datatypes': False}10055371100 7to_tsv13.83415.7631000000108{}6343972285 8to_text13.93715.6821000000108{}6376771751 9to_html12.5780.531000000228{}18867927950310to_hdf55.0112.3451000000316{}81004199600 <p>Conclusions</p> <p>Best:</p> <ul> <li>to/from JSON wins with 2.3M rps read</li> <li>to/from CSV/TSV/TEXT comes 2nd with config <code>guess_datatypes=False</code> with ~ 100k rps</li> </ul> <p>Worst:</p> <ul> <li>to/from ods burst the memory footprint and hence had to be reduced to 100k rows. It also had the slowest read rate with 1450 rps.</li> </ul> In\u00a0[17]: Copied! <pre>def contains_benchmark(table):\n    results = Table()\n    results.add_columns( \"column\", \"time (s)\" )\n    for name,col in table.columns.items():\n        n = len(col)\n        start,stop,step = int(n*0.02), int(n*0.98), int(n/100)\n        selection = col[start:stop:step]\n        total_time = 0.0\n        for v in selection:\n            start_time = perf_counter()\n            v in col  # &lt;--- test!\n            end_time = perf_counter()\n            total_time += (end_time - start_time)\n        avg_time = total_time / len(selection)\n        results.add_rows( name, round(avg_time,3) )\n\n    return results\n</pre> def contains_benchmark(table):     results = Table()     results.add_columns( \"column\", \"time (s)\" )     for name,col in table.columns.items():         n = len(col)         start,stop,step = int(n*0.02), int(n*0.98), int(n/100)         selection = col[start:stop:step]         total_time = 0.0         for v in selection:             start_time = perf_counter()             v in col  # &lt;--- test!             end_time = perf_counter()             total_time += (end_time - start_time)         avg_time = total_time / len(selection)         results.add_rows( name, round(avg_time,3) )      return results      In\u00a0[18]: Copied! <pre>has_it = contains_benchmark(tables[-1])\nhas_it\n</pre> has_it = contains_benchmark(tables[-1]) has_it Out[18]: #columntime (s) 0#0.001 110.043 220.032 330.001 440.001 550.001 660.006 770.003 880.006 990.00710100.04311110.655 In\u00a0[19]: Copied! <pre>def slicing_benchmark(table):\n    n = len(table)\n    start,stop,step = int(0.02*n), int(0.98*n), int(n / 20)  # from 2% to 98% in 20 large steps\n    start_time = perf_counter()\n    snip = table[start:stop:step]\n    end_time = perf_counter()\n    print(f\"reading {len(table):,} rows to find {len(snip):,} rows took {end_time-start_time:.3f} sec\")\n    return snip\n</pre> def slicing_benchmark(table):     n = len(table)     start,stop,step = int(0.02*n), int(0.98*n), int(n / 20)  # from 2% to 98% in 20 large steps     start_time = perf_counter()     snip = table[start:stop:step]     end_time = perf_counter()     print(f\"reading {len(table):,} rows to find {len(snip):,} rows took {end_time-start_time:.3f} sec\")     return snip In\u00a0[20]: Copied! <pre>slice_it = slicing_benchmark(tables[-1])\n</pre> slice_it = slicing_benchmark(tables[-1]) <pre>reading 50,000,000 rows to find 20 rows took 1.435 sec\n</pre> In\u00a0[22]: Copied! <pre>def column_selection_benchmark(tables):\n    results = Table()\n    results.add_columns( 'rows')\n    results.add_columns(*[f\"n cols={i}\" for i,_ in enumerate(tables[0].columns,start=1)])\n\n    for table in tables:\n        rr = [len(table)]\n        for ix, name in enumerate(table.columns):\n            cols = list(table.columns)[:ix+1]\n            start_time = perf_counter()\n            table[cols]\n            end_time = perf_counter()\n            rr.append(f\"{end_time-start_time:.5f}\")\n        results.add_rows( rr )\n    return results\n</pre> def column_selection_benchmark(tables):     results = Table()     results.add_columns( 'rows')     results.add_columns(*[f\"n cols={i}\" for i,_ in enumerate(tables[0].columns,start=1)])      for table in tables:         rr = [len(table)]         for ix, name in enumerate(table.columns):             cols = list(table.columns)[:ix+1]             start_time = perf_counter()             table[cols]             end_time = perf_counter()             rr.append(f\"{end_time-start_time:.5f}\")         results.add_rows( rr )     return results In\u00a0[23]: Copied! <pre>csb = column_selection_benchmark(tables)\nprint(\"times below are are in seconds\")\ncsb\n</pre> csb = column_selection_benchmark(tables) print(\"times below are are in seconds\") csb <pre>times below are are in seconds\n</pre> Out[23]: #rowsn cols=1n cols=2n cols=3n cols=4n cols=5n cols=6n cols=7n cols=8n cols=9n cols=10n cols=11n cols=12 010000000.000010.000060.000040.000040.000040.000040.000040.000040.000040.000040.000040.00004 120000000.000010.000080.000030.000030.000030.000030.000030.000030.000030.000030.000040.00004 250000000.000010.000050.000040.000040.000040.000040.000040.000040.000040.000040.000040.00004 3100000000.000020.000050.000040.000040.000040.000040.000070.000050.000050.000050.000050.00005 4200000000.000030.000060.000050.000050.000050.000050.000060.000060.000060.000060.000060.00006 5500000000.000090.000110.000100.000090.000090.000090.000090.000090.000090.000090.000100.00009 In\u00a0[33]: Copied! <pre>def iterrows_benchmark(table):\n    results = Table()\n    results.add_columns( 'n columns', 'time (s)')\n\n    columns = ['1']\n    for column in list(table.columns):\n        columns.append(column)\n        snip = table[columns, slice(500_000,1_500_000)]\n        start_time = perf_counter()\n        counts = 0\n        for row in snip.rows:\n            counts += 1\n        end_time = perf_counter()\n        results.add_rows( len(columns), round(end_time-start_time,3))\n\n    return results\n</pre> def iterrows_benchmark(table):     results = Table()     results.add_columns( 'n columns', 'time (s)')      columns = ['1']     for column in list(table.columns):         columns.append(column)         snip = table[columns, slice(500_000,1_500_000)]         start_time = perf_counter()         counts = 0         for row in snip.rows:             counts += 1         end_time = perf_counter()         results.add_rows( len(columns), round(end_time-start_time,3))      return results  In\u00a0[34]: Copied! <pre>iterb = iterrows_benchmark(tables[-1])\niterb\n</pre> iterb = iterrows_benchmark(tables[-1]) iterb Out[34]: #n columnstime (s) 029.951 139.816 249.859 359.93 469.985 579.942 689.958 799.867 8109.96 9119.93210129.8311139.861 In\u00a0[35]: Copied! <pre>import matplotlib.pyplot as plt\nplt.plot(iterb['n columns'], iterb['time (s)'])\nplt.show()\n</pre> import matplotlib.pyplot as plt plt.plot(iterb['n columns'], iterb['time (s)']) plt.show()  In\u00a0[28]: Copied! <pre>tables[-1].types()\n</pre> tables[-1].types() Out[28]: <pre>{'#': {int: 50000000},\n '1': {int: 50000000},\n '2': {str: 50000000},\n '3': {int: 50000000},\n '4': {int: 50000000},\n '5': {int: 50000000},\n '6': {str: 50000000},\n '7': {str: 50000000},\n '8': {str: 50000000},\n '9': {str: 50000000},\n '10': {float: 50000000},\n '11': {str: 50000000}}</pre> In\u00a0[29]: Copied! <pre>def dtypes_benchmark(tables):\n    dtypes_results = Table()\n    dtypes_results.add_columns(\"rows\", \"time (s)\")\n\n    for table in tables:\n        start_time = perf_counter()\n        dt = table.types()\n        end_time = perf_counter()\n        assert isinstance(dt, dict) and len(dt) != 0\n        dtypes_results.add_rows( len(table), round(end_time-start_time, 3) )\n\n    return dtypes_results\n</pre> def dtypes_benchmark(tables):     dtypes_results = Table()     dtypes_results.add_columns(\"rows\", \"time (s)\")      for table in tables:         start_time = perf_counter()         dt = table.types()         end_time = perf_counter()         assert isinstance(dt, dict) and len(dt) != 0         dtypes_results.add_rows( len(table), round(end_time-start_time, 3) )      return dtypes_results In\u00a0[30]: Copied! <pre>dtype_b = dtypes_benchmark(tables)\ndtype_b\n</pre> dtype_b = dtypes_benchmark(tables) dtype_b Out[30]: #rowstime (s) 010000000.0 120000000.0 250000000.0 3100000000.0 4200000000.0 5500000000.001 In\u00a0[31]: Copied! <pre>def any_benchmark(tables):\n    results = Table()\n    results.add_columns(\"rows\", *list(tables[0].columns))\n\n    for table in tables:\n        tmp = [len(table)]\n        for column in list(table.columns):\n            v = table[column][0]\n            start_time = perf_counter()\n            _ = table.any(**{column: v})\n            end_time = perf_counter()           \n            tmp.append(round(end_time-start_time,3))\n\n        results.add_rows( tmp )\n    return results\n</pre> def any_benchmark(tables):     results = Table()     results.add_columns(\"rows\", *list(tables[0].columns))      for table in tables:         tmp = [len(table)]         for column in list(table.columns):             v = table[column][0]             start_time = perf_counter()             _ = table.any(**{column: v})             end_time = perf_counter()                        tmp.append(round(end_time-start_time,3))          results.add_rows( tmp )     return results  In\u00a0[32]: Copied! <pre>anyb = any_benchmark(tables)\nanyb\n</pre>  anyb = any_benchmark(tables) anyb Out[32]: ~rows#1234567891011 010000000.1330.1330.1780.1330.2920.1470.1690.1430.2270.2590.1460.17 120000000.2680.2630.3430.2650.5670.2940.3350.2750.4640.5230.2890.323 250000000.6690.6530.9140.6691.4360.7230.8380.6941.1741.3350.6780.818 3100000001.3141.351.7451.3362.9021.491.6831.4142.3542.6181.3431.536 4200000002.5562.5343.3372.6025.6452.8273.2252.6464.5145.082.6933.083 5500000006.5716.4238.4556.69914.4847.9897.7986.25910.98912.486.7327.767 In\u00a0[36]: Copied! <pre>def all_benchmark(tables):\n    results = Table()\n    results.add_columns(\"rows\", *list(tables[0].columns))\n\n    for table in tables:\n        tmp = [len(table)]\n        for column in list(table.columns):\n            v = table[column][0]\n            start_time = perf_counter()\n            _ = table.all(**{column: v})\n            end_time = perf_counter()           \n            tmp.append(round(end_time-start_time,3))\n\n        results.add_rows( tmp )\n    return results\n</pre> def all_benchmark(tables):     results = Table()     results.add_columns(\"rows\", *list(tables[0].columns))      for table in tables:         tmp = [len(table)]         for column in list(table.columns):             v = table[column][0]             start_time = perf_counter()             _ = table.all(**{column: v})             end_time = perf_counter()                        tmp.append(round(end_time-start_time,3))          results.add_rows( tmp )     return results  In\u00a0[37]: Copied! <pre>allb = all_benchmark(tables)\nallb\n</pre> allb = all_benchmark(tables) allb Out[37]: ~rows#1234567891011 010000000.120.1210.1620.1220.2640.1380.1550.1270.2090.2370.1330.151 120000000.2370.2350.3110.2380.520.2660.2970.3410.4510.530.2610.285 250000000.6750.6980.9520.5941.6050.6590.8120.7191.2241.3530.6640.914 3100000001.3141.3321.7071.3323.0911.4631.7811.3662.3582.6381.4091.714 4200000002.5762.3133.112.3965.2072.5732.9212.4034.0414.6582.4632.808 5500000005.8965.827.735.95612.9097.457.275.98110.18311.5766.3727.414 In\u00a0[\u00a0]: Copied! <pre>\n</pre> In\u00a0[38]: Copied! <pre>def unique_benchmark(tables):\n    results = Table()\n    results.add_columns(\"rows\", *list(tables[0].columns))\n    \n    for table in tables:\n        length = len(table)\n\n        tmp = [len(table)]\n        for column in list(table.columns):\n            start_time = perf_counter()\n            try:\n                L = table[column].unique()\n                dt = perf_counter() - start_time\n            except MemoryError:\n                dt = -1\n            tmp.append(round(dt,3))\n            assert 0 &lt; len(L) &lt;= length    \n\n        results.add_rows( tmp )\n    return results\n</pre> def unique_benchmark(tables):     results = Table()     results.add_columns(\"rows\", *list(tables[0].columns))          for table in tables:         length = len(table)          tmp = [len(table)]         for column in list(table.columns):             start_time = perf_counter()             try:                 L = table[column].unique()                 dt = perf_counter() - start_time             except MemoryError:                 dt = -1             tmp.append(round(dt,3))             assert 0 &lt; len(L) &lt;= length              results.add_rows( tmp )     return results In\u00a0[39]: Copied! <pre>ubm = unique_benchmark(tables)\nubm\n</pre> ubm = unique_benchmark(tables) ubm Out[39]: ~rows#1234567891011 010000000.0220.0810.2480.0440.0160.0610.1150.1360.0960.0850.0940.447 120000000.1760.2710.5050.0870.0310.1240.2290.2790.1980.170.3051.471 250000000.1980.4991.2630.2180.0760.3110.570.6850.4740.4250.5952.744 3100000000.5021.1232.5350.4330.1550.6151.1281.3750.960.851.3165.826 4200000000.9562.3365.0350.8830.3191.2292.2682.7481.9131.7462.73311.883 5500000002.3956.01912.4992.1780.7643.0735.6086.8194.8284.2797.09730.511 In\u00a0[40]: Copied! <pre>def index_benchmark(tables):\n    results = Table()\n    results.add_columns(\"rows\", *list(tables[0].columns))\n    \n    for table in tables:\n\n        tmp = [len(table)]\n        for column in list(table.columns):\n            start_time = perf_counter()\n            try:\n                _ = table.index(column)\n                dt = perf_counter() - start_time\n            except MemoryError:\n                dt = -1\n            tmp.append(round(dt,3))\n            \n        results.add_rows( tmp )\n    return results\n</pre> def index_benchmark(tables):     results = Table()     results.add_columns(\"rows\", *list(tables[0].columns))          for table in tables:          tmp = [len(table)]         for column in list(table.columns):             start_time = perf_counter()             try:                 _ = table.index(column)                 dt = perf_counter() - start_time             except MemoryError:                 dt = -1             tmp.append(round(dt,3))                      results.add_rows( tmp )     return results   In\u00a0[41]: Copied! <pre>ibm = index_benchmark(tables)\nibm\n</pre> ibm = index_benchmark(tables) ibm Out[41]: ~rows#1234567891011 010000001.9491.7931.4321.1061.0511.231.3381.4931.4111.3031.9992.325 120000002.8833.5172.8562.2172.1242.4622.6762.9862.7092.6064.0494.461 250000006.3829.0497.0965.6285.3536.3126.6497.5216.716.45910.2710.747 31000000012.55318.50613.9511.33510.72412.50913.3315.05113.50212.89919.76921.999 42000000024.71737.89628.56822.66621.47226.32727.15730.06427.33225.82238.31143.399 55000000063.01697.07772.00755.60954.09961.79768.23675.0769.02266.15299.183109.969 <p>Multi-column index next:</p> In\u00a0[42]: Copied! <pre>def multi_column_index_benchmark(tables):\n    \n    selection = [\"4\", \"7\", \"8\", \"9\"]\n    results = Table()\n    results.add_columns(\"rows\", *range(1,len(selection)+1))\n    \n    for table in tables:\n\n        tmp = [len(table)]\n        for index in range(1,5):\n            start_time = perf_counter()\n            try:\n                _ = table.index(*selection[:index])\n                dt = perf_counter() - start_time\n            except MemoryError:\n                dt = -1\n            tmp.append(round(dt,3))\n            print('.', end='')\n            \n        results.add_rows( tmp )\n    return results\n</pre> def multi_column_index_benchmark(tables):          selection = [\"4\", \"7\", \"8\", \"9\"]     results = Table()     results.add_columns(\"rows\", *range(1,len(selection)+1))          for table in tables:          tmp = [len(table)]         for index in range(1,5):             start_time = perf_counter()             try:                 _ = table.index(*selection[:index])                 dt = perf_counter() - start_time             except MemoryError:                 dt = -1             tmp.append(round(dt,3))             print('.', end='')                      results.add_rows( tmp )     return results   In\u00a0[43]: Copied! <pre>mcib = multi_column_index_benchmark(tables)\nmcib\n</pre> mcib = multi_column_index_benchmark(tables) mcib <pre>........................</pre> Out[43]: #rows1234 010000001.0582.1333.2154.052 120000002.124.2786.5468.328 250000005.30310.8916.69320.793 31000000010.58122.40733.46241.91 42000000021.06445.95467.78184.828 55000000052.347109.551166.6211.053 In\u00a0[44]: Copied! <pre>def drop_duplicates_benchmark(tables):\n    results = Table()\n    results.add_columns(\"rows\", *list(tables[0].columns))\n    \n    for table in tables:\n        result = [len(table)]\n        cols = []\n        for name in list(table.columns):\n            cols.append(name)\n            start_time = perf_counter()\n            try:\n                _ = table.drop_duplicates(*cols)\n                dt = perf_counter() - start_time\n            except MemoryError:\n                dt = -1\n            result.append(round(dt,3))\n            print('.', end='')\n        \n        results.add_rows( result )\n    return results\n</pre> def drop_duplicates_benchmark(tables):     results = Table()     results.add_columns(\"rows\", *list(tables[0].columns))          for table in tables:         result = [len(table)]         cols = []         for name in list(table.columns):             cols.append(name)             start_time = perf_counter()             try:                 _ = table.drop_duplicates(*cols)                 dt = perf_counter() - start_time             except MemoryError:                 dt = -1             result.append(round(dt,3))             print('.', end='')                  results.add_rows( result )     return results   In\u00a0[45]: Copied! <pre>ddb = drop_duplicates_benchmark(tables)\nddb\n</pre> ddb = drop_duplicates_benchmark(tables) ddb <pre>........................................................................</pre> Out[45]: ~rows#1234567891011 010000001.7612.3583.3133.9014.6154.9615.8356.5347.4548.1088.8039.682 120000003.0114.936.9347.979.26410.26812.00613.51714.9216.63117.93219.493 250000006.82713.85318.63721.23724.54827.1131.15735.02638.99243.53146.02250.433 31000000013.23831.74641.14146.91753.17258.24167.99274.65182.7491.45897.666104.82 42000000025.93277.75100.34109.314123.514131.874148.432163.57179.121196.047208.686228.059 55000000064.237312.222364.886388.249429.724466.685494.418535.367581.666607.306634.343683.858"},{"location":"benchmarks/#benchmarks","title":"Benchmarks\u00b6","text":"<p>These benchmarks seek to establish the performance of tablite as a user sees it.</p> <p>Overview</p> Input/Output Various column functions Base functions Core functions - Save / Load .tpz format- Save tables to various formats- Import data from various formats - Setitem / getitem- iter- equal, not equal- copy- t += t- t *= t- contains- remove all- replace- index- unique- histogram- statistics- count - Setitem / getitem- iter / rows- equal, not equal- load- save- copy- stack- types- display_dict- show- to_dict- as_json_serializable- index - expression- filter- sort_index- reindex- drop_duplicates- sort- is_sorted- any- all- drop - replace- groupby- pivot- joins- lookup- replace missing values- transpose- pivot_transpose- diff"},{"location":"benchmarks/#input-output","title":"Input / Output\u00b6","text":""},{"location":"benchmarks/#create-tables-from-synthetic-data","title":"Create tables from synthetic data.\u00b6","text":""},{"location":"benchmarks/#save-load-tpz-format","title":"Save / Load .tpz format\u00b6","text":"<p>Without default compression settings (10% slower than uncompressed, 20% of uncompressed filesize)</p>"},{"location":"benchmarks/#save-load-tables-to-from-various-formats","title":"Save / load tables to / from various formats\u00b6","text":"<p>The handlers for saving / export are:</p> <ul> <li>to_sql</li> <li>to_json</li> <li>to_xls</li> <li>to_ods</li> <li>to_csv</li> <li>to_tsv</li> <li>to_text</li> <li>to_html</li> <li>to_hdf5</li> </ul>"},{"location":"benchmarks/#various-column-functions","title":"Various column functions\u00b6","text":"<ul> <li>Setitem / getitem</li> <li>iter</li> <li>equal, not equal</li> <li>copy</li> <li>t += t</li> <li>t *= t</li> <li>contains</li> <li>remove all</li> <li>replace</li> <li>index</li> <li>unique</li> <li>histogram</li> <li>statistics</li> <li>count</li> </ul>"},{"location":"benchmarks/#various-table-functions","title":"Various table functions\u00b6","text":""},{"location":"benchmarks/#slicing","title":"Slicing\u00b6","text":"<p>Slicing operations are used in many places.</p>"},{"location":"benchmarks/#tabletypes","title":"Table.types()\u00b6","text":"<p>Table.types() is implemented for near constant speed lookup.</p> <p>Here is an example:</p>"},{"location":"benchmarks/#tableany","title":"Table.any\u00b6","text":""},{"location":"benchmarks/#tableall","title":"Table.all\u00b6","text":""},{"location":"benchmarks/#tablefilter","title":"Table.filter\u00b6","text":""},{"location":"benchmarks/#tableunique","title":"Table.unique\u00b6","text":""},{"location":"benchmarks/#tableindex","title":"Table.index\u00b6","text":"<p>Single column index first:</p>"},{"location":"benchmarks/#drop-duplicates","title":"drop duplicates\u00b6","text":""},{"location":"changelog/","title":"Changelog","text":"Version Change 2023.9.0 Adding <code>Table.match</code> operation. 2023.8.0 Nim backend for csv importer.Improve excel importer.Improve slicing consistency.Logical cores re-enabled on *nix based systems.Filter is now type safe.Added merge utility.Various bugfixes. 2023.6.5 Fix issues with <code>get_headers</code> falling back to text reading when reading 0 lines of excel, fix issue where reading excel file would ignore file count, excel file reader now has parity for linecount selection. 2023.6.4 Fix a logic bug in <code>get_headers</code> that caused one extra line to be returned than requested. 2023.6.3 Updated the way reference counting works. Tablite now tracks references to used pages and cleans them up based on number of references to those pages in the current process. This change allows to handle deep table clones when sending tables via processes (pickling/unpickling), whereas previous implementation would corrupt all tables using same pages due to reference counting asserting that all tables are shallow copies to the same object. 2023.6.2 Updated <code>mplite</code> dependency, changed to soft version requirement to prevent pipeline freezes due to small bugfixes in <code>mplite</code>. 2023.6.1 Major change of the backend processes. Speed up of ~6x. For more see the release notes 2022.11.19 Fixed some memory leaks. 2022.11.18 <code>copy</code>, <code>filter</code>, <code>sort</code>, <code>any</code>, <code>all</code> methods now properly respects the table subclass.Filter for tables with under <code>SINGLE_PROCESSING_LIMIT</code> rows will run on same process to reduce overhead.Errors within child processes now properly propagate to parent.<code>Table.reset_storage(include_imports=True)</code> now allows the user to reset the storage but exclude any imported files by setting <code>include_imports=False</code> during <code>Table.reset(...)</code>.Bug: A column with <code>1,None,2</code> would be written to csv &amp; tsv as <code>\"1,None,2\"</code>. Now it is written <code>\"1,,2\"</code> where None means absent.Fix mp <code>join</code> producing mismatched columns lengths when different table lengths are used as an input or when join product is longer than the input table. 2022.11.17 <code>Table.load</code> now properly subclassess the table instead of always resulting in <code>tablite.Table</code>.<code>Table.from_*</code> methods now respect subclassess, fixed some <code>from_*</code> methods which were instance methods and not class methods.Fixed <code>Table.from_dict</code> only accepting <code>list</code> and <code>tuple</code> but not <code>tablite.Column</code> which is an equally valid type.Fix <code>lookup</code> parity in single process and multiple process outputs.Fix an issue with multiprocess <code>lookup</code> where no matches would throw instead of producing <code>None</code>.Fix an issue with filtering an empty table. 2022.11.16 Changed <code>join</code> to process 1M rows per task to avoid potential OOM on lower memory systems. Added <code>mp_merge_columns</code> to <code>MemoryManager</code> that merges column pages into a single column.Fix <code>join</code> parity in single process and multiple process outputs.Fix an issue with multiprocess <code>join</code> where no matches would throw instead of producing <code>None</code>. 2022.11.15 Bump <code>mplite</code> to avoid deadlock issues OS kill the process. 2022.11.14 Improve locking mechanism to allow retries when opening file as the previous solution could cause deadlocks when running multiple threads. 2022.11.13 Fix an issue with copying empty pages. 2022.11.12 Tablite now is now able to create it's own temporary directory. 2022.11.11 <code>text_reader</code> tqdm tracks the entire process now.  <code>text_reader</code> properly respects free memory in *nix based systems.  <code>text_reader</code> no longer discriminates against hyperthreaded cores. 2022.11.10 <code>get_headers</code> now uses plain <code>openpyxl</code> instead of <code>pyexcel</code> wrapper to speed up fetch times ~10x on certain files. 2022.11.9 <code>get_headers</code> can fail safe on unrecognized characters. 2022.11.8 Fix a bug with task size calculation on single core systems. 2022.11.7 Added <code>TABLITE_TMPDIR</code> environment variable for setting tablite work directory.  Characters that fail to be read text reader due to improper encoding will be skipped.  Fixed an issue where single column text files with no column delimiters would be imported as empty tables. 2022.11.6 Date inference fix 2022.11.5 Fixed negative slicing issues 2022.11.4 Transpose API changes:  <code>table.transpose(...)</code> was renamed to <code>table.pivot_transpose(...)</code>  new <code>table.transpose()</code> and <code>table.T</code> were added, it's functionality acts similarly to <code>numpy.T</code>, the column headers are used the first row in the table when transposing. 2022.11.3 Bugfix for non-ascii encoded strings during <code>t.add_rows(...)</code> 2022.11.2 As <code>utf-8</code> is ascii compatible, the file reader utils selects <code>utf-8</code> instead of <code>ascii</code> as a default. 2022.11.1 bugfix in <code>datatypes.infer()</code> where 1 was inferred as int, not float. 2022.11.0 New table features: <code>Table.diff(other, columns=...)</code>, <code>table.remove_duplicates_rows()</code>, <code>table.drop_na(*arg)</code>,<code>table.replace(target,replacement)</code>, <code>table.imputation(sources, targets, methods=...)</code>, <code>table.to_pandas()</code> and <code>Table.from_pandas(pd.DataFrame)</code>,<code>table.to_dict(columns, slice)</code>, <code>Table.from_dict()</code>,<code>table.transpose(columns, keep, ...)</code>, New column features:  <code>Column.count(item)</code>, <code>Column[:]</code> is guaranteed to return a python list.<code>Column.to_numpy(slice)</code> returns <code>np.ndarray</code>.  new <code>tools</code> library: <code>from tablite import tools</code> with:  <code>date_range(start,end)</code>, <code>xround(value, multiple, up=None)</code>, and,  <code>guess</code> as short-cut for <code>Datatypes.guess(...)</code>. bugfixes:  <code>__eq__</code> was updated but missed <code>__ne__</code>.<code>in</code> operator in filter would crash if datatypes were not strings. 2022.10.11 filter now accepts any expression (str) that can be compiled by pythons compiler 2022.10.11 Bugfix for <code>.any</code> and <code>.all</code>. The code now executes much faster 2022.10.10 Bugfix for <code>Table.import_file</code>: <code>import_as</code> has been removed from keywords. 2022.10.10 All Table functions now have tqdm progressbar. 2022.10.10 More robust calculation for task size for multiprocessing. 2022.10.10 Dependency update: mplite==1.2.0 is now required. 2022.10.9 Bugfix for <code>Table.import_file</code>: files with duplicate header names would only have last duplicate name imported.Now the headers are made unique using <code>name_x</code> where x is a number. 2022.10.8 Bugfix for groupby: Where keys are empty error should have been raised.Where there are no functions, unique keypairs are returned. 2022.10.7 Bugfix for Column.statistics() for an empty column 2022.10.6 Bugfix for <code>__setitem__</code>: tbl['a'] = [] is now seen as <code>tbl.add_column('a')</code>Bugfix for <code>__getitem__</code>: calling a missing key raises keyerror. 2022.10.5 Bugfix for summary statistics. 2022.10.4 Bugfix for join shortcut. 2022.10.3 Bugfix for DataTypes where bool was evaluated wrongly 2022.10.0 Added ability to reindex in <code>table.reindex(index=[0,1...,n,n-1])</code> 2022.9.0 Added ability to store python objects (example).Added warning when user iterates over non-rectangular dataset. 2022.8.0 Added <code>table.export(path)</code> which exports tablite Tables to file format given by the file extension. For example <code>my_table.export('example.xlsx')</code>.supported formats are: <code>json</code>, <code>html</code>, <code>xlsx</code>, <code>xls</code>, <code>csv</code>, <code>tsv</code>, <code>txt</code>, <code>ods</code> and <code>sql</code>. 2022.7.8 Added ability to forward <code>tqdm</code> progressbar into <code>Table.import_file(..., tqdm=your_tqdm)</code>, so that Jupyter notebook can use it in <code>display</code>-methods. 2022.7.7 Added method <code>Table.to_sql()</code> for export to ANSI-92 SQL enginesBugfix on to_json for <code>timedelta</code>. Jupyter notebook provides nice view using <code>Table._repr_html_()</code> JS-users can use <code>.as_json_serializable</code> where suitable. 2022.7.6 get_headers now takes argument <code>(path, linecount=10)</code> 2022.7.5 added helper <code>Table.as_json_serializable</code> as Jupyterkernel compat. 2022.7.4 adder helper <code>Table.to_dict</code>, and updated <code>Table.to_json</code> 2022.7.3 table.to_json now takes kwargs: <code>row_count</code>, <code>columns</code>, <code>slice_</code>, <code>start_on</code> 2022.7.2 documentation update. 2022.7.1 minor bugfix. 2022.7.0 BREAKING CHANGES- Tablite now uses HDF5 as backend. - Has multiprocessing enabled by default. - Is 20x faster. - Completely new API. 2022.6.0 <code>DataTypes.guess([list of strings])</code> returns the best matching python datatype."},{"location":"tutorial/","title":"Tutorial","text":"In\u00a0[1]: Copied! <pre>from tablite import Table\n\n## To create a tablite table is as simple as populating a dictionary:\nt = Table({'A':[1,2,3], 'B':['a','b','c']})\n</pre> from tablite import Table  ## To create a tablite table is as simple as populating a dictionary: t = Table({'A':[1,2,3], 'B':['a','b','c']}) In\u00a0[2]: Copied! <pre>## In this notebook we can show tables in the HTML style:\nt\n</pre> ## In this notebook we can show tables in the HTML style: t Out[2]: #AB 01a 12b 23c In\u00a0[3]: Copied! <pre>## or the ascii style:\nt.show()\n</pre> ## or the ascii style: t.show() <pre>+==+=+=+\n|# |A|B|\n+--+-+-+\n| 0|1|a|\n| 1|2|b|\n| 2|3|c|\n+==+=+=+\n</pre> In\u00a0[4]: Copied! <pre>## or if you'd like to inspect the table, use:\nprint(str(t))\n</pre> ## or if you'd like to inspect the table, use: print(str(t)) <pre>Table(2 columns, 3 rows)\n</pre> In\u00a0[5]: Copied! <pre>## You can also add all columns at once (slower) if you prefer. \nt2 = Table(headers=('A','B'), rows=((1,'a'),(2,'b'),(3,'c')))\nassert t==t2\n</pre> ## You can also add all columns at once (slower) if you prefer.  t2 = Table(headers=('A','B'), rows=((1,'a'),(2,'b'),(3,'c'))) assert t==t2 In\u00a0[6]: Copied! <pre>## or load data:\nt3 = Table.from_file('tests/data/book1.csv')\n\n## to view any table in the notebook just let jupyter show the table. If you're using the terminal use .show(). \n## Note that show gives either first and last 7 rows or the whole table if it is less than 20 rows.\nt3\n</pre> ## or load data: t3 = Table.from_file('tests/data/book1.csv')  ## to view any table in the notebook just let jupyter show the table. If you're using the terminal use .show().  ## Note that show gives either first and last 7 rows or the whole table if it is less than 20 rows. t3 <pre>Collecting tasks: 'tests/data/book1.csv'\nDumping tasks: 'tests/data/book1.csv'\n</pre> <pre>importing file: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 1/1 [00:00&lt;00:00, 487.82it/s]\n</pre> Out[6]: #abcdef 010.0606060610.0909090910.1212121210.1515151520.181818182 120.1212121210.2424242420.4848484850.969696971.939393939 230.2424242420.4848484850.969696971.9393939393.878787879 340.4848484850.969696971.9393939393.8787878797.757575758 450.969696971.9393939393.8787878797.75757575815.51515152 561.9393939393.8787878797.75757575815.5151515231.03030303 673.8787878797.75757575815.5151515231.0303030362.06060606.....................383916659267088.033318534175.066637068350.0133274000000.0266548000000.0394033318534175.066637068350.0133274000000.0266548000000.0533097000000.0404166637068350.0133274000000.0266548000000.0533097000000.01066190000000.04142133274000000.0266548000000.0533097000000.01066190000000.02132390000000.04243266548000000.0533097000000.01066190000000.02132390000000.04264770000000.04344533097000000.01066190000000.02132390000000.04264770000000.08529540000000.044451066190000000.02132390000000.04264770000000.08529540000000.017059100000000.0 In\u00a0[7]: Copied! <pre>## should you however want to select the headers instead of importing everything\n## (which maybe timeconsuming), simply use get_headers(path)\nfrom tablite.tools import get_headers\nfrom pathlib import Path\npath = Path('tests/data/book1.csv')\nsample = get_headers(path, linecount=5)\nprint(f\"sample is of type {type(sample)} and has the following entries:\")\nfor k,v in sample.items():\n    print(k)\n    if isinstance(v,list):\n        for r in sample[k]:\n            print(\"\\t\", r)\n</pre> ## should you however want to select the headers instead of importing everything ## (which maybe timeconsuming), simply use get_headers(path) from tablite.tools import get_headers from pathlib import Path path = Path('tests/data/book1.csv') sample = get_headers(path, linecount=5) print(f\"sample is of type {type(sample)} and has the following entries:\") for k,v in sample.items():     print(k)     if isinstance(v,list):         for r in sample[k]:             print(\"\\t\", r) <pre>sample is of type &lt;class 'dict'&gt; and has the following entries:\ndelimiter\nbook1.csv\n\t ['a', 'b', 'c', 'd', 'e', 'f']\n\t ['1', '0.060606061', '0.090909091', '0.121212121', '0.151515152', '0.181818182']\n\t ['2', '0.121212121', '0.242424242', '0.484848485', '0.96969697', '1.939393939']\n\t ['3', '0.242424242', '0.484848485', '0.96969697', '1.939393939', '3.878787879']\n\t ['4', '0.484848485', '0.96969697', '1.939393939', '3.878787879', '7.757575758']\n\t ['5', '0.96969697', '1.939393939', '3.878787879', '7.757575758', '15.51515152']\n</pre> In\u00a0[8]: Copied! <pre>## to extend a table by adding columns, use t[new] = [new values]\nt['C'] = [4,5,6]\n## but make sure the column has the same length as the rest of the table!\nt\n</pre> ## to extend a table by adding columns, use t[new] = [new values] t['C'] = [4,5,6] ## but make sure the column has the same length as the rest of the table! t Out[8]: #ABC 01a4 12b5 23c6 In\u00a0[9]: Copied! <pre>## should you want to mix datatypes, tablite will not complain:\nfrom datetime import datetime, date,time,timedelta\nimport numpy as np\n## What you put in ...\nt4 = Table()\nt4['mixed'] = [\n    -1,0,1,  # regular integers\n    -12345678909876543211234567890987654321,  # very very large integer\n    None,np.nan,  # null values \n    \"one\", \"\",  # strings\n    True,False,  # booleans\n    float('inf'), 0.01,  # floats\n    date(2000,1,1),   # date\n    datetime(2002,2,3,23,0,4,6660),  # datetime\n    time(12,12,12),  # time\n    timedelta(days=3, seconds=5678)  # timedelta\n]\n## ... is exactly what you get out:\nt4\n</pre> ## should you want to mix datatypes, tablite will not complain: from datetime import datetime, date,time,timedelta import numpy as np ## What you put in ... t4 = Table() t4['mixed'] = [     -1,0,1,  # regular integers     -12345678909876543211234567890987654321,  # very very large integer     None,np.nan,  # null values      \"one\", \"\",  # strings     True,False,  # booleans     float('inf'), 0.01,  # floats     date(2000,1,1),   # date     datetime(2002,2,3,23,0,4,6660),  # datetime     time(12,12,12),  # time     timedelta(days=3, seconds=5678)  # timedelta ] ## ... is exactly what you get out: t4 Out[9]: #mixed 0-1 10 21 3-12345678909876543211234567890987654321 4None 5nan 6one 7 8True 9False10inf110.01122000-01-01132002-02-03 23:00:04.0066601412:12:12153 days, 1:34:38 In\u00a0[10]: Copied! <pre>## also if you claim the values back as a python list:\nfor item in list(t4['mixed']):\n    print(item)\n</pre> ## also if you claim the values back as a python list: for item in list(t4['mixed']):     print(item) <pre>-1\n0\n1\n-12345678909876543211234567890987654321\nNone\nnan\none\n\nTrue\nFalse\ninf\n0.01\n2000-01-01\n2002-02-03 23:00:04.006660\n12:12:12\n3 days, 1:34:38\n</pre> <p>The column itself (<code>__repr__</code>) shows us the <code>pid</code>, <code>file location</code> and the entries, so you know exactly what you're working with.</p> In\u00a0[11]: Copied! <pre>t4['mixed']\n</pre> t4['mixed'] Out[11]: <pre>Column(/tmp/tablite-tmp/pid-54911, [-1 0 1 -12345678909876543211234567890987654321 None nan 'one' '' True\n False inf 0.01 datetime.date(2000, 1, 1)\n datetime.datetime(2002, 2, 3, 23, 0, 4, 6660) datetime.time(12, 12, 12)\n datetime.timedelta(days=3, seconds=5678)])</pre> In\u00a0[12]: Copied! <pre>## to view the datatypes in a column, use Column.types()\ntype_dict = t4['mixed'].types()\nfor k,v in type_dict.items():\n    print(k,v)\n</pre> ## to view the datatypes in a column, use Column.types() type_dict = t4['mixed'].types() for k,v in type_dict.items():     print(k,v) <pre>&lt;class 'int'&gt; 4\n&lt;class 'NoneType'&gt; 1\n&lt;class 'float'&gt; 3\n&lt;class 'str'&gt; 2\n&lt;class 'bool'&gt; 2\n&lt;class 'datetime.date'&gt; 1\n&lt;class 'datetime.datetime'&gt; 1\n&lt;class 'datetime.time'&gt; 1\n&lt;class 'datetime.timedelta'&gt; 1\n</pre> In\u00a0[13]: Copied! <pre>## You may have noticed that all datatypes in t3 where identified as floats, despite their origin from a text type file.\n## This is because tablite guesses the most probable datatype using the `.guess` function on each column.\n## You can use the .guess function like this:\nfrom tablite import DataTypes\nt3['a'] = DataTypes.guess(t3['a'])\n## You can also convert the datatype using a list comprehension\nt3['b'] = [float(v) for v in t3['b']]\nt3\n</pre> ## You may have noticed that all datatypes in t3 where identified as floats, despite their origin from a text type file. ## This is because tablite guesses the most probable datatype using the `.guess` function on each column. ## You can use the .guess function like this: from tablite import DataTypes t3['a'] = DataTypes.guess(t3['a']) ## You can also convert the datatype using a list comprehension t3['b'] = [float(v) for v in t3['b']] t3 Out[13]: #abcdef 010.0606060610.0909090910.1212121210.1515151520.181818182 120.1212121210.2424242420.4848484850.969696971.939393939 230.2424242420.4848484850.969696971.9393939393.878787879 340.4848484850.969696971.9393939393.8787878797.757575758 450.969696971.9393939393.8787878797.75757575815.51515152 561.9393939393.8787878797.75757575815.5151515231.03030303 673.8787878797.75757575815.5151515231.0303030362.06060606.....................383916659267088.033318534175.066637068350.0133274000000.0266548000000.0394033318534175.066637068350.0133274000000.0266548000000.0533097000000.0404166637068350.0133274000000.0266548000000.0533097000000.01066190000000.04142133274000000.0266548000000.0533097000000.01066190000000.02132390000000.04243266548000000.0533097000000.01066190000000.02132390000000.04264770000000.04344533097000000.01066190000000.02132390000000.04264770000000.08529540000000.044451066190000000.02132390000000.04264770000000.08529540000000.017059100000000.0 In\u00a0[14]: Copied! <pre>t = Table()\nfor column_name in 'abcde':\n    t[column_name] =[i for i in range(5)]\n</pre> t = Table() for column_name in 'abcde':     t[column_name] =[i for i in range(5)] <p>(2) we want to add two new columns using the functions:</p> In\u00a0[15]: Copied! <pre>def f1(a,b,c):\n    return a+b+c+1\ndef f2(b,c,d):\n    return b*c*d\n</pre> def f1(a,b,c):     return a+b+c+1 def f2(b,c,d):     return b*c*d <p>(3) and we want to compute two new columns <code>f</code> and <code>g</code>:</p> In\u00a0[16]: Copied! <pre>t.add_columns('f', 'g')\n</pre> t.add_columns('f', 'g') <p>(4) we can now use the filter, to iterate over the table, and add the values to the two new columns:</p> In\u00a0[17]: Copied! <pre>f,g=[],[]\nfor row in t['a', 'b', 'c', 'd'].rows:\n    a, b, c, d = row\n\n    f.append(f1(a, b, c))\n    g.append(f2(b, c, d))\nt['f'] = f\nt['g'] = g\n\nassert len(t) == 5\nassert list(t.columns) == list('abcdefg')\nt\n</pre> f,g=[],[] for row in t['a', 'b', 'c', 'd'].rows:     a, b, c, d = row      f.append(f1(a, b, c))     g.append(f2(b, c, d)) t['f'] = f t['g'] = g  assert len(t) == 5 assert list(t.columns) == list('abcdefg') t Out[17]: #abcdefg 00000010 11111141 22222278 3333331027 4444441364 <p>Take note that if your dataset is assymmetric, a warning will be show:</p> In\u00a0[18]: Copied! <pre>assymmetric_table = Table({'a':[1,2,3], 'b':[1,2]})\nfor row in assymmetric_table.rows:\n    print(row)\n## warning at the bottom ---v\n</pre> assymmetric_table = Table({'a':[1,2,3], 'b':[1,2]}) for row in assymmetric_table.rows:     print(row) ## warning at the bottom ---v <pre>[1, 1]\n[2, 2]\n[3, None]\n</pre> <pre>/home/bjorn/github/tablite/tablite/base.py:1188: UserWarning: Column b has length 2 / 3. None will appear as fill value.\n  warnings.warn(f\"Column {name} has length {len(column)} / {n_max}. None will appear as fill value.\")\n</pre> In\u00a0[19]: Copied! <pre>table7 = Table(columns={\n'A': [1,1,2,2,3,4],\n'B': [1,1,2,2,30,40],\n'C': [-1,-2,-3,-4,-5,-6]\n})\nindex = table7.index('A', 'B')\nfor k, v in index.items():\n    print(\"key\", k, \"indices\", v)\n</pre> table7 = Table(columns={ 'A': [1,1,2,2,3,4], 'B': [1,1,2,2,30,40], 'C': [-1,-2,-3,-4,-5,-6] }) index = table7.index('A', 'B') for k, v in index.items():     print(\"key\", k, \"indices\", v) <pre>key (1, 1) indices [0, 1]\nkey (2, 2) indices [2, 3]\nkey (3, 30) indices [4]\nkey (4, 40) indices [5]\n</pre> <p>The keys are created for each unique column-key-pair, and the value is the index where the key is found. To fetch all rows for key <code>(2,2)</code>, we can use:</p> In\u00a0[20]: Copied! <pre>for ix, row in enumerate(table7.rows):\n    if ix in index[(2,2)]:\n        print(row)\n</pre> for ix, row in enumerate(table7.rows):     if ix in index[(2,2)]:         print(row) <pre>[2, 2, -3]\n[2, 2, -4]\n</pre> In\u00a0[21]: Copied! <pre>## to append one table to another, use + or += \nprint('length before:', len(t3))  # length before: 45\nt5 = t3 + t3  \nprint('length after +', len(t5))  # length after + 90\nt5 += t3 \nprint('length after +=', len(t5))  # length after += 135\n## if you need a lot of numbers for a test, you can repeat a table using * and *=\nt5 *= 1_000\nprint('length after +=', len(t5))  # length after += 135000\n</pre> ## to append one table to another, use + or +=  print('length before:', len(t3))  # length before: 45 t5 = t3 + t3   print('length after +', len(t5))  # length after + 90 t5 += t3  print('length after +=', len(t5))  # length after += 135 ## if you need a lot of numbers for a test, you can repeat a table using * and *= t5 *= 1_000 print('length after +=', len(t5))  # length after += 135000 <pre>length before: 45\nlength after + 90\nlength after += 135\nlength after += 135000\n</pre> In\u00a0[22]: Copied! <pre>t5\n</pre> t5   Out[22]: #abcdef       010.0606060610.0909090910.1212121210.1515151520.181818182       120.1212121210.2424242420.4848484850.969696971.939393939       230.2424242420.4848484850.969696971.9393939393.878787879       340.4848484850.969696971.9393939393.8787878797.757575758       450.969696971.9393939393.8787878797.75757575815.51515152       561.9393939393.8787878797.75757575815.5151515231.03030303       673.8787878797.75757575815.5151515231.0303030362.06060606..................... 134,9933916659267088.033318534175.066637068350.0133274000000.0266548000000.0 134,9944033318534175.066637068350.0133274000000.0266548000000.0533097000000.0 134,9954166637068350.0133274000000.0266548000000.0533097000000.01066190000000.0 134,99642133274000000.0266548000000.0533097000000.01066190000000.02132390000000.0 134,99743266548000000.0533097000000.01066190000000.02132390000000.04264770000000.0 134,99844533097000000.01066190000000.02132390000000.04264770000000.08529540000000.0 134,999451066190000000.02132390000000.04264770000000.08529540000000.017059100000000.0 In\u00a0[23]: Copied! <pre>## if your are in doubt whether your tables will be the same you can use .stack(other)\nassert t.columns != t2.columns  # compares list of column names.\nt6 = t.stack(t2)\nt6\n</pre> ## if your are in doubt whether your tables will be the same you can use .stack(other) assert t.columns != t2.columns  # compares list of column names. t6 = t.stack(t2) t6 Out[23]: #abcdefgAB 00000010NoneNone 11111141NoneNone 22222278NoneNone 3333331027NoneNone 4444441364NoneNone 5NoneNoneNoneNoneNoneNoneNone1a 6NoneNoneNoneNoneNoneNoneNone2b 7NoneNoneNoneNoneNoneNoneNone3c In\u00a0[24]: Copied! <pre>## As you can see above, t6['C'] is padded with \"None\" where t2 was missing the columns.\n\n## if you need a more detailed view of the columns you can iterate:\nfor name in t.columns:\n    col_from_t = t[name]\n    if name in t2.columns:\n        col_from_t2 = t2[name]\n        print(name, col_from_t == col_from_t2)\n    else:\n        print(name, \"not in t2\")\n</pre> ## As you can see above, t6['C'] is padded with \"None\" where t2 was missing the columns.  ## if you need a more detailed view of the columns you can iterate: for name in t.columns:     col_from_t = t[name]     if name in t2.columns:         col_from_t2 = t2[name]         print(name, col_from_t == col_from_t2)     else:         print(name, \"not in t2\") <pre>a not in t2\nb not in t2\nc not in t2\nd not in t2\ne not in t2\nf not in t2\ng not in t2\n</pre> In\u00a0[25]: Copied! <pre>## to make a copy of a table, use table.copy()\nt3_copy = t3.copy()\n\n## you can also perform multi criteria selections using getitem [ ... ]\nt3_slice = t3['a','b','d', 5:25:5]\nt3_slice\n</pre> ## to make a copy of a table, use table.copy() t3_copy = t3.copy()  ## you can also perform multi criteria selections using getitem [ ... ] t3_slice = t3['a','b','d', 5:25:5] t3_slice Out[25]: #abd 061.9393939397.757575758 11162.06060606248.2424242 2161985.9393947943.757576 32163550.06061254200.2424 In\u00a0[26]: Copied! <pre>##deleting items also works the same way:\ndel t3_slice[1:3]  # delete row number 2 &amp; 3 \nt3_slice\n</pre> ##deleting items also works the same way: del t3_slice[1:3]  # delete row number 2 &amp; 3  t3_slice Out[26]: #abd 061.9393939397.757575758 12163550.06061254200.2424 In\u00a0[27]: Copied! <pre>## to wipe a table, use .clear:\nt3_slice.clear()\nt3_slice\n</pre> ## to wipe a table, use .clear: t3_slice.clear() t3_slice Out[27]: Empty Table In\u00a0[28]: Copied! <pre>## tablite uses .npy for storage because it is fast.\n## this means you can make a table persistent using .save\nlocal_file = Path(\"local_file.tpz\")\nt5.save(local_file)\n\nold_t5 = Table.load(local_file)\nprint(\"the t5 table had\", len(old_t5), \"rows\")  # the t5 table had 135000 rows\n\ndel old_t5  # only removes the in-memory object\n\nprint(\"old_t5 still exists?\", local_file.exists())\nprint(\"path:\", local_file)\n\nimport os\nos.remove(local_file)\n</pre> ## tablite uses .npy for storage because it is fast. ## this means you can make a table persistent using .save local_file = Path(\"local_file.tpz\") t5.save(local_file)  old_t5 = Table.load(local_file) print(\"the t5 table had\", len(old_t5), \"rows\")  # the t5 table had 135000 rows  del old_t5  # only removes the in-memory object  print(\"old_t5 still exists?\", local_file.exists()) print(\"path:\", local_file)  import os os.remove(local_file) <pre>loading 'local_file.tpz' file:  55%|\u2588\u2588\u2588\u2588\u2588\u258d    | 9851/18000 [00:02&lt;00:01, 4386.96it/s]</pre> <pre>loading 'local_file.tpz' file: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 18000/18000 [00:04&lt;00:00, 4417.27it/s]\n</pre> <pre>the t5 table had 135000 rows\nold_t5 still exists? True\npath: local_file.tpz\n</pre> <p>If you want to save a table from one session to another use <code>save=True</code>. This tells the garbage collector to leave the tablite Table on disk, so you can load it again without changing your code.</p> <p>For example:</p> <p>First time you run <code>t = Table.import_file(....big.csv)</code> it may take a minute or two.</p> <p>If you then add <code>t.save=True</code> and restart python, the second time you run  <code>t = Table.import_file(....big.csv)</code> it will take a few milliseconds instead of minutes.</p> In\u00a0[29]: Copied! <pre>unfiltered = Table({'a':[1,2,3,4], 'b':[10,20,30,40]})\n</pre> unfiltered = Table({'a':[1,2,3,4], 'b':[10,20,30,40]}) In\u00a0[30]: Copied! <pre>true,false = unfiltered.filter(\n    [\n        {\"column1\": 'a', \"criteria\":\"&gt;=\", 'value2':3}\n    ], filter_type='all'\n)\n</pre> true,false = unfiltered.filter(     [         {\"column1\": 'a', \"criteria\":\"&gt;=\", 'value2':3}     ], filter_type='all' ) In\u00a0[31]: Copied! <pre>true\n</pre> true Out[31]: #ab 0330 1440 In\u00a0[32]: Copied! <pre>false.show()  # using show here to show that terminal users can have a nice view too.\n</pre> false.show()  # using show here to show that terminal users can have a nice view too. <pre>+==+=+==+\n|# |a|b |\n+--+-+--+\n| 0|1|10|\n| 1|2|20|\n+==+=+==+\n</pre> In\u00a0[33]: Copied! <pre>ty = Table({'a':[1,2,3,4],'b': [10,20,30,40]})\n</pre> ty = Table({'a':[1,2,3,4],'b': [10,20,30,40]}) In\u00a0[34]: Copied! <pre>## typical python\nany(i &gt; 3 for i in ty['a'])\n</pre> ## typical python any(i &gt; 3 for i in ty['a']) Out[34]: <pre>True</pre> In\u00a0[35]: Copied! <pre>## hereby you can do:\nany( ty.any(**{'a':lambda x:x&gt;3}).rows )\n</pre> ## hereby you can do: any( ty.any(**{'a':lambda x:x&gt;3}).rows ) Out[35]: <pre>True</pre> In\u00a0[36]: Copied! <pre>## if you have multiple criteria this also works:\nall( ty.all(**{'a': lambda x:x&gt;=2, 'b': lambda x:x&lt;=30}).rows )\n</pre> ## if you have multiple criteria this also works: all( ty.all(**{'a': lambda x:x&gt;=2, 'b': lambda x:x&lt;=30}).rows ) Out[36]: <pre>True</pre> In\u00a0[37]: Copied! <pre>## or this if you want to see the table.\nty.all(a=lambda x:x&gt;2, b=lambda x:x&lt;=30)\n</pre> ## or this if you want to see the table. ty.all(a=lambda x:x&gt;2, b=lambda x:x&lt;=30) Out[37]: #ab 0330 In\u00a0[38]: Copied! <pre>## As `all` and `any` returns tables, this also means that you can chain operations:\nty.any(a=lambda x:x&gt;2).any(b=30)\n</pre> ## As `all` and `any` returns tables, this also means that you can chain operations: ty.any(a=lambda x:x&gt;2).any(b=30) Out[38]: #ab 0330 In\u00a0[39]: Copied! <pre>table = Table({\n    'A':[ 1, None, 8, 3, 4, 6,  5,  7,  9],\n    'B':[10,'100', 1, 1, 1, 1, 10, 10, 10],\n    'C':[ 0,    1, 0, 1, 0, 1,  0,  1,  0],\n})\ntable\n</pre> table = Table({     'A':[ 1, None, 8, 3, 4, 6,  5,  7,  9],     'B':[10,'100', 1, 1, 1, 1, 10, 10, 10],     'C':[ 0,    1, 0, 1, 0, 1,  0,  1,  0], }) table Out[39]: #ABC 01100 1None1001 2810 3311 4410 5611 65100 77101 89100 In\u00a0[40]: Copied! <pre>sort_order = {'B': False, 'C': False, 'A': False}\nassert not table.is_sorted(mapping=sort_order)\n\nsorted_table = table.sort(mapping=sort_order)\nsorted_table\n</pre> sort_order = {'B': False, 'C': False, 'A': False} assert not table.is_sorted(mapping=sort_order)  sorted_table = table.sort(mapping=sort_order) sorted_table <pre>creating sort index: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 3/3 [00:00&lt;00:00, 2719.45it/s]\ncreating sort index: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 3/3 [00:00&lt;00:00, 3434.20it/s]\njoin: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 3/3 [00:00&lt;00:00, 1902.47it/s]\n</pre> <p>Sort is reasonable effective as it uses multiprocessing above a million fields.</p> <p>Hint: You can set this limit in <code>tablite.config</code>, like this:</p> In\u00a0[41]: Copied! <pre>from tablite.config import Config\nprint(f\"multiprocessing is used above {Config.SINGLE_PROCESSING_LIMIT:,} fields\")\n</pre> from tablite.config import Config print(f\"multiprocessing is used above {Config.SINGLE_PROCESSING_LIMIT:,} fields\") <pre>multiprocessing is used above 1,000,000 fields\n</pre> In\u00a0[42]: Copied! <pre>import math\nn = math.ceil(1_000_000 / (9*3))\n\ntable = Table({\n    'A':[ 1, None, 8, 3, 4, 6,  5,  7,  9]*n,\n    'B':[10,'100', 1, 1, 1, 1, 10, 10, 10]*n,\n    'C':[ 0,    1, 0, 1, 0, 1,  0,  1,  0]*n,\n})\ntable\n</pre> import math n = math.ceil(1_000_000 / (9*3))  table = Table({     'A':[ 1, None, 8, 3, 4, 6,  5,  7,  9]*n,     'B':[10,'100', 1, 1, 1, 1, 10, 10, 10]*n,     'C':[ 0,    1, 0, 1, 0, 1,  0,  1,  0]*n, }) table Out[42]: #ABC       01100       1None1001       2810       3311       4410       5611       65100............ 333,335810 333,336311 333,337410 333,338611 333,3395100 333,3407101 333,3419100 In\u00a0[43]: Copied! <pre>import time as cputime\nstart = cputime.time()\nsort_order = {'B': False, 'C': False, 'A': False}\nsorted_table = table.sort(mapping=sort_order)  # sorts 1M values.\nprint(\"table sorting took \", round(cputime.time() - start,3), \"secs\")\nsorted_table\n</pre> import time as cputime start = cputime.time() sort_order = {'B': False, 'C': False, 'A': False} sorted_table = table.sort(mapping=sort_order)  # sorts 1M values. print(\"table sorting took \", round(cputime.time() - start,3), \"secs\") sorted_table <pre>creating sort index: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 3/3 [00:00&lt;00:00,  4.20it/s]\njoin: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 3/3 [00:00&lt;00:00, 18.17it/s]</pre> <pre>table sorting took  0.913 secs\n</pre> <pre>\n</pre> In\u00a0[44]: Copied! <pre>n = math.ceil(1_000_000 / (9*3))\n\ntable = Table({\n    'A':[ 1, None, 8, 3, 4, 6,  5,  7,  9]*n,\n    'B':[10,'100', 1, 1, 1, 1, 10, 10, 10]*n,\n    'C':[ 0,    1, 0, 1, 0, 1,  0,  1,  0]*n,\n})\ntable\n</pre> n = math.ceil(1_000_000 / (9*3))  table = Table({     'A':[ 1, None, 8, 3, 4, 6,  5,  7,  9]*n,     'B':[10,'100', 1, 1, 1, 1, 10, 10, 10]*n,     'C':[ 0,    1, 0, 1, 0, 1,  0,  1,  0]*n, }) table  Out[44]: #ABC       01100       1None1001       2810       3311       4410       5611       65100............ 333,335810 333,336311 333,337410 333,338611 333,3395100 333,3407101 333,3419100 In\u00a0[45]: Copied! <pre>from tablite import GroupBy as gb\ngrpby = table.groupby(keys=['C', 'B'], functions=[('A', gb.count)])\ngrpby\n</pre> from tablite import GroupBy as gb grpby = table.groupby(keys=['C', 'B'], functions=[('A', gb.count)]) grpby <pre>groupby: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 333342/333342 [00:00&lt;00:00, 427322.50it/s]\n</pre> Out[45]: #CBCount(A) 0010111114 1110037038 20174076 31174076 411037038 <p>Here is the list of groupby functions:</p> <pre><code>class GroupBy(object):    \n    max = Max  # shortcuts to avoid having to type a long list of imports.\n    min = Min\n    sum = Sum\n    product = Product\n    first = First\n    last = Last\n    count = Count\n    count_unique = CountUnique\n    avg = Average\n    stdev = StandardDeviation\n    median = Median\n    mode = Mode\n</code></pre> In\u00a0[46]: Copied! <pre>t = Table({\n    'A':[1, 1, 2, 2, 3, 3] * 2,\n    'B':[1, 2, 3, 4, 5, 6] * 2,\n    'C':[6, 5, 4, 3, 2, 1] * 2,\n})\nt\n</pre> t = Table({     'A':[1, 1, 2, 2, 3, 3] * 2,     'B':[1, 2, 3, 4, 5, 6] * 2,     'C':[6, 5, 4, 3, 2, 1] * 2, }) t Out[46]: #ABC 0116 1125 2234 3243 4352 5361 6116 7125 8234 92431035211361 In\u00a0[47]: Copied! <pre>t2 = t.pivot(rows=['C'], columns=['A'], functions=[('B', gb.sum), ('B', gb.count)], values_as_rows=False)\nt2\n</pre> t2 = t.pivot(rows=['C'], columns=['A'], functions=[('B', gb.sum), ('B', gb.count)], values_as_rows=False) t2 <pre>pivot: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 14/14 [00:00&lt;00:00, 3643.83it/s]\n</pre> Out[47]: #CSum(B,A=1)Count(B,A=1)Sum(B,A=2)Count(B,A=2)Sum(B,A=3)Count(B,A=3) 0622NoneNoneNoneNone 1542NoneNoneNoneNone 24NoneNone62NoneNone 33NoneNone82NoneNone 42NoneNoneNoneNone102 51NoneNoneNoneNone122 In\u00a0[48]: Copied! <pre>numbers = Table()\nnumbers.add_column('number', data=[      1,      2,       3,       4,   None])\nnumbers.add_column('colour', data=['black', 'blue', 'white', 'white', 'blue'])\n\nletters = Table()\nletters.add_column('letter', data=[  'a',     'b',      'c',     'd',   None])\nletters.add_column('color', data=['blue', 'white', 'orange', 'white', 'blue'])\n</pre> numbers = Table() numbers.add_column('number', data=[      1,      2,       3,       4,   None]) numbers.add_column('colour', data=['black', 'blue', 'white', 'white', 'blue'])  letters = Table() letters.add_column('letter', data=[  'a',     'b',      'c',     'd',   None]) letters.add_column('color', data=['blue', 'white', 'orange', 'white', 'blue'])  In\u00a0[49]: Copied! <pre>## left join\n## SELECT number, letter FROM numbers LEFT JOIN letters ON numbers.colour == letters.color\nleft_join = numbers.left_join(letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter'])\nleft_join\n</pre> ## left join ## SELECT number, letter FROM numbers LEFT JOIN letters ON numbers.colour == letters.color left_join = numbers.left_join(letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter']) left_join <pre>join: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 2/2 [00:00&lt;00:00, 1221.94it/s]\n</pre> Out[49]: #numberletter 01None 12a 22None 3Nonea 4NoneNone 53b 63d 74b 84d In\u00a0[50]: Copied! <pre>## inner join\n## SELECT number, letter FROM numbers JOIN letters ON numbers.colour == letters.color\ninner_join = numbers.inner_join(letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter'])\ninner_join\n</pre> ## inner join ## SELECT number, letter FROM numbers JOIN letters ON numbers.colour == letters.color inner_join = numbers.inner_join(letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter']) inner_join <pre>join: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 2/2 [00:00&lt;00:00, 1121.77it/s]\n</pre> Out[50]: #numberletter 02a 12None 2Nonea 3NoneNone 43b 53d 64b 74d In\u00a0[51]: Copied! <pre># outer join\n## SELECT number, letter FROM numbers OUTER JOIN letters ON numbers.colour == letters.color\nouter_join = numbers.outer_join(letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter'])\nouter_join\n</pre>  # outer join ## SELECT number, letter FROM numbers OUTER JOIN letters ON numbers.colour == letters.color outer_join = numbers.outer_join(letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter']) outer_join <pre>join: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 2/2 [00:00&lt;00:00, 1585.15it/s]\n</pre> Out[51]: #numberletter 01None 12a 22None 3Nonea 4NoneNone 53b 63d 74b 84d 9Nonec <p>Q: But ...I think there's a bug in the join... A: Venn diagrams do not explain joins.</p> <p>A Venn diagram is a widely-used diagram style that shows the logical relation between sets, popularised by John Venn in the 1880s. The diagrams are used to teach elementary set theory, and to illustrate simple set relationshipssource: en.wikipedia.org</p> <p>Joins operate over rows and when there are duplicate rows, these will be replicated in the output. Many beginners are surprised by this, because they didn't read the SQL standard.</p> <p>Q: So what do I do? A: If you want to get rid of duplicates using tablite, use the <code>index</code> functionality across all columns and pick the first row from each index. Here's the recipe that starts with plenty of duplicates:</p> In\u00a0[52]: Copied! <pre>old_table = Table({\n'A':[1,1,1,2,2,2,3,3,3],\n'B':[1,1,4,2,2,5,3,3,6],\n})\nold_table\n</pre> old_table = Table({ 'A':[1,1,1,2,2,2,3,3,3], 'B':[1,1,4,2,2,5,3,3,6], }) old_table Out[52]: #AB 011 111 214 322 422 525 633 733 836 In\u00a0[53]: Copied! <pre>## CREATE TABLE OF UNIQUE ENTRIES (a.k.a. DEDUPLICATE)\nnew_table = old_table.drop_duplicates()\nnew_table\n</pre> ## CREATE TABLE OF UNIQUE ENTRIES (a.k.a. DEDUPLICATE) new_table = old_table.drop_duplicates() new_table <pre>9it [00:00, 11329.15it/s]\njoin: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 2/2 [00:00&lt;00:00, 1819.26it/s]\n</pre> Out[53]: #AB 011 114 222 325 433 536 <p>You can also use groupby; We'll get to that in a minute.</p> <p>Lookup is a special case of a search loop: Say for example you are planning a concert and want to make sure that your friends can make it home using public transport: You would have to find the first departure after the concert ends towards their home. A join would only give you a direct match on the time.</p> <p>Lookup allows you \"to iterate through a list of data and find the first match given a set of criteria.\"</p> <p>Here's an example:</p> <p>First we have our list of friends and their stops.</p> In\u00a0[54]: Copied! <pre>friends = Table({\n\"name\":['Alice', 'Betty', 'Charlie', 'Dorethy', 'Edward', 'Fred'],\n\"stop\":['Downtown-1', 'Downtown-2', 'Hillside View', 'Hillside Crescent', 'Downtown-2', 'Chicago'],\n})\nfriends\n</pre> friends = Table({ \"name\":['Alice', 'Betty', 'Charlie', 'Dorethy', 'Edward', 'Fred'], \"stop\":['Downtown-1', 'Downtown-2', 'Hillside View', 'Hillside Crescent', 'Downtown-2', 'Chicago'], }) friends Out[54]: #namestop 0AliceDowntown-1 1BettyDowntown-2 2CharlieHillside View 3DorethyHillside Crescent 4EdwardDowntown-2 5FredChicago <p>Next we need a list of bus routes and their time and stops. I don't have that, so I'm making one up:</p> In\u00a0[55]: Copied! <pre>import random\nrandom.seed(11)\ntable_size = 40\n\ntimes = [DataTypes.time(random.randint(21, 23), random.randint(0, 59)) for i in range(table_size)]\nstops = ['Stadium', 'Hillside', 'Hillside View', 'Hillside Crescent', 'Downtown-1', 'Downtown-2',\n            'Central station'] * 2 + [f'Random Road-{i}' for i in range(table_size)]\nroute = [random.choice([1, 2, 3]) for i in stops]\n</pre>  import random random.seed(11) table_size = 40  times = [DataTypes.time(random.randint(21, 23), random.randint(0, 59)) for i in range(table_size)] stops = ['Stadium', 'Hillside', 'Hillside View', 'Hillside Crescent', 'Downtown-1', 'Downtown-2',             'Central station'] * 2 + [f'Random Road-{i}' for i in range(table_size)] route = [random.choice([1, 2, 3]) for i in stops]  In\u00a0[56]: Copied! <pre>bus_table = Table({\n\"time\":times,\n\"stop\":stops[:table_size],\n\"route\":route[:table_size],\n})\nbus_table.sort(mapping={'time': False})\n\nprint(\"Departures from Concert Hall towards ...\")\nbus_table[0:10]\n</pre>  bus_table = Table({ \"time\":times, \"stop\":stops[:table_size], \"route\":route[:table_size], }) bus_table.sort(mapping={'time': False})  print(\"Departures from Concert Hall towards ...\") bus_table[0:10]  <pre>creating sort index: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 1/1 [00:00&lt;00:00, 1459.90it/s]\njoin: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 3/3 [00:00&lt;00:00, 2421.65it/s]\n</pre> <pre>Departures from Concert Hall towards ...\n</pre> Out[56]: #timestoproute 021:02:00Random Road-62 121:05:00Hillside Crescent2 221:06:00Hillside1 321:25:00Random Road-241 421:29:00Random Road-161 521:32:00Random Road-211 621:33:00Random Road-121 721:36:00Random Road-233 821:38:00Central station2 921:38:00Random Road-82 <p>Let's say the concerts ends at 21:00 and it takes a 10 minutes to get to the bus-stop. Earliest departure must then be 21:10 - goodbye hugs included.</p> In\u00a0[57]: Copied! <pre>lookup_1 = friends.lookup(bus_table, (DataTypes.time(21, 10), \"&lt;=\", 'time'), ('stop', \"==\", 'stop'))\nlookup1_sorted = lookup_1.sorted(mapping={'time': False, 'name':False}, sort_mode='unix')\nlookup1_sorted\n</pre> lookup_1 = friends.lookup(bus_table, (DataTypes.time(21, 10), \"&lt;=\", 'time'), ('stop', \"==\", 'stop')) lookup1_sorted = lookup_1.sorted(mapping={'time': False, 'name':False}, sort_mode='unix') lookup1_sorted <pre>100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 6/6 [00:00&lt;00:00, 1513.92it/s]\njoin: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 3/3 [00:00&lt;00:00, 2003.65it/s]\ncreating sort index: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 2/2 [00:00&lt;00:00, 2589.88it/s]\njoin: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 5/5 [00:00&lt;00:00, 2034.29it/s]\n</pre> Out[57]: #namestoptimestop_1route 0FredChicagoNoneNoneNone 1BettyDowntown-221:51:00Downtown-21 2EdwardDowntown-221:51:00Downtown-21 3CharlieHillside View22:19:00Hillside View2 4AliceDowntown-123:12:00Downtown-13 5DorethyHillside Crescent23:54:00Hillside Crescent1 <p>Lookup's ability to custom criteria is thereby far more versatile than SQL joins.</p> <p>But with great power comes great responsibility.</p> In\u00a0[58]: Copied! <pre>materials = Table({\n    'bom_id': [1, 2, 3, 4, 5, 6, 7, 8, 9], \n    'partial_of': [1, 2, 3, 4, 5, 6, 7, 4, 6], \n    'sku': ['A', 'irrelevant', 'empty carton', 'pkd carton', 'empty pallet', 'pkd pallet', 'pkd irrelevant', 'ppkd carton', 'ppkd pallet'], \n    'material_id': [None, None, None, 3, None, 5, 3, 3, 5], \n    'quantity': [10, 20, 30, 40, 50, 60, 70, 80, 90]\n})\n    # 9 is a partially packed pallet of 6\n\n## multiple values.\nlooking_for = Table({\n    'bom_id': [3,4,6], \n    'moq': [1,2,3]\n    })\n</pre> materials = Table({     'bom_id': [1, 2, 3, 4, 5, 6, 7, 8, 9],      'partial_of': [1, 2, 3, 4, 5, 6, 7, 4, 6],      'sku': ['A', 'irrelevant', 'empty carton', 'pkd carton', 'empty pallet', 'pkd pallet', 'pkd irrelevant', 'ppkd carton', 'ppkd pallet'],      'material_id': [None, None, None, 3, None, 5, 3, 3, 5],      'quantity': [10, 20, 30, 40, 50, 60, 70, 80, 90] })     # 9 is a partially packed pallet of 6  ## multiple values. looking_for = Table({     'bom_id': [3,4,6],      'moq': [1,2,3]     })  <p>Our goals is now to find the quantity from the <code>materials</code> table based on the items in the <code>looking_for</code> table.</p> <p>This requires two steps:</p> <ol> <li>lookup</li> <li>filter for <code>all</code> by dropping items that didn't match.</li> </ol> In\u00a0[59]: Copied! <pre>## step 1/2:\nproducts_lookup = materials.lookup(looking_for, (\"bom_id\", \"==\", \"bom_id\"), (\"partial_of\", \"==\", \"bom_id\"), all=False)   \nproducts_lookup\n</pre> ## step 1/2: products_lookup = materials.lookup(looking_for, (\"bom_id\", \"==\", \"bom_id\"), (\"partial_of\", \"==\", \"bom_id\"), all=False)    products_lookup <pre>100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 9/9 [00:00&lt;00:00, 3651.81it/s]\njoin: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 2/2 [00:00&lt;00:00, 1625.38it/s]\n</pre> Out[59]: #bom_idpartial_ofskumaterial_idquantitybom_id_1moq 011ANone10NoneNone 122irrelevantNone20NoneNone 233empty cartonNone3031 344pkd carton34042 455empty palletNone50NoneNone 566pkd pallet56063 677pkd irrelevant370NoneNone 784ppkd carton38042 896ppkd pallet59063 In\u00a0[60]: Copied! <pre>## step 2/2:\nproducts = products_lookup.all(bom_id_1=lambda x: x is not None)\nproducts\n</pre> ## step 2/2: products = products_lookup.all(bom_id_1=lambda x: x is not None) products Out[60]: #bom_idpartial_ofskumaterial_idquantitybom_id_1moq 033empty cartonNone3031 144pkd carton34042 266pkd pallet56063 384ppkd carton38042 496ppkd pallet59063 <p>The faster way to solve this problem is to use <code>match</code>!</p> <p>Here is the example:</p> In\u00a0[61]: Copied! <pre>products_matched = materials.match(looking_for, (\"bom_id\", \"==\", \"bom_id\"), (\"partial_of\", \"==\", \"bom_id\"))\nproducts_matched\n</pre> products_matched = materials.match(looking_for, (\"bom_id\", \"==\", \"bom_id\"), (\"partial_of\", \"==\", \"bom_id\")) products_matched Out[61]: #bom_idpartial_ofskumaterial_idquantitybom_id_1moq 033empty cartonNone3031 144pkd carton34042 266pkd pallet56063 384ppkd carton38042 496ppkd pallet59063 In\u00a0[62]: Copied! <pre>assert products == products_matched\n</pre> assert products == products_matched In\u00a0[63]: Copied! <pre>from tablite import Table\nt = Table()  # create table\nt.add_columns('row','A','B','C')  # add columns\n</pre> from tablite import Table t = Table()  # create table t.add_columns('row','A','B','C')  # add columns <p>The following examples are all valid and append the row (1,2,3) to the table.</p> In\u00a0[64]: Copied! <pre>t.add_rows(1, 1, 2, 3)  # individual values\nt.add_rows([2, 1, 2, 3])  # list of values\nt.add_rows((3, 1, 2, 3))  # tuple of values\nt.add_rows(*(4, 1, 2, 3))  # unpacked tuple\nt.add_rows(row=5, A=1, B=2, C=3)   # keyword - args\nt.add_rows(**{'row': 6, 'A': 1, 'B': 2, 'C': 3})  # dict / json.\n</pre> t.add_rows(1, 1, 2, 3)  # individual values t.add_rows([2, 1, 2, 3])  # list of values t.add_rows((3, 1, 2, 3))  # tuple of values t.add_rows(*(4, 1, 2, 3))  # unpacked tuple t.add_rows(row=5, A=1, B=2, C=3)   # keyword - args t.add_rows(**{'row': 6, 'A': 1, 'B': 2, 'C': 3})  # dict / json. <p>The following examples add two rows to the table</p> In\u00a0[65]: Copied! <pre>t.add_rows((7, 1, 2, 3), (8, 4, 5, 6))  # two (or more) tuples.\nt.add_rows([9, 1, 2, 3], [10, 4, 5, 6])  # two or more lists\nt.add_rows({'row': 11, 'A': 1, 'B': 2, 'C': 3},\n          {'row': 12, 'A': 4, 'B': 5, 'C': 6})  # two (or more) dicts as args.\nt.add_rows(*[{'row': 13, 'A': 1, 'B': 2, 'C': 3},\n            {'row': 14, 'A': 1, 'B': 2, 'C': 3}])  # list of dicts.\n</pre> t.add_rows((7, 1, 2, 3), (8, 4, 5, 6))  # two (or more) tuples. t.add_rows([9, 1, 2, 3], [10, 4, 5, 6])  # two or more lists t.add_rows({'row': 11, 'A': 1, 'B': 2, 'C': 3},           {'row': 12, 'A': 4, 'B': 5, 'C': 6})  # two (or more) dicts as args. t.add_rows(*[{'row': 13, 'A': 1, 'B': 2, 'C': 3},             {'row': 14, 'A': 1, 'B': 2, 'C': 3}])  # list of dicts. In\u00a0[66]: Copied! <pre>t\n</pre> t Out[66]: #rowABC 01123 12123 23123 34123 45123 56123 67123 78456 89123 9104561011123111245612131231314123 <p>As the row incremented from <code>1</code> in the first of these examples, and finished with <code>row: 14</code>, you can now see the whole table above</p> In\u00a0[67]: Copied! <pre>from pathlib import Path\npath = Path('tests/data/book1.csv')\ntx = Table.from_file(path)\ntx\n</pre> from pathlib import Path path = Path('tests/data/book1.csv') tx = Table.from_file(path) tx  <pre>Collecting tasks: 'tests/data/book1.csv'\nDumping tasks: 'tests/data/book1.csv'\n</pre> <pre>importing file: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 1/1 [00:00&lt;00:00, 444.08it/s]\n</pre> Out[67]: #abcdef 010.0606060610.0909090910.1212121210.1515151520.181818182 120.1212121210.2424242420.4848484850.969696971.939393939 230.2424242420.4848484850.969696971.9393939393.878787879 340.4848484850.969696971.9393939393.8787878797.757575758 450.969696971.9393939393.8787878797.75757575815.51515152 561.9393939393.8787878797.75757575815.5151515231.03030303 673.8787878797.75757575815.5151515231.0303030362.06060606.....................383916659267088.033318534175.066637068350.0133274000000.0266548000000.0394033318534175.066637068350.0133274000000.0266548000000.0533097000000.0404166637068350.0133274000000.0266548000000.0533097000000.01066190000000.04142133274000000.0266548000000.0533097000000.01066190000000.02132390000000.04243266548000000.0533097000000.01066190000000.02132390000000.04264770000000.04344533097000000.01066190000000.02132390000000.04264770000000.08529540000000.044451066190000000.02132390000000.04264770000000.08529540000000.017059100000000.0 <p>Note that you can also add start, limit and chunk_size to the file reader. Here's an example:</p> In\u00a0[68]: Copied! <pre>path = Path('tests/data/book1.csv')\ntx2 = Table.from_file(path, start=2, limit=15)\ntx2\n</pre> path = Path('tests/data/book1.csv') tx2 = Table.from_file(path, start=2, limit=15) tx2 <pre>Collecting tasks: 'tests/data/book1.csv'\n</pre> <pre>importing file: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 1/1 [00:00&lt;00:00, 391.22it/s]</pre> <pre>Dumping tasks: 'tests/data/book1.csv'\n</pre> <pre>\n</pre> Out[68]: #abcdef 030.2424242420.4848484850.969696971.9393939393.878787879 140.4848484850.969696971.9393939393.8787878797.757575758 250.969696971.9393939393.8787878797.75757575815.51515152 361.9393939393.8787878797.75757575815.5151515231.03030303 473.8787878797.75757575815.5151515231.0303030362.06060606 587.75757575815.5151515231.0303030362.06060606124.1212121 6915.5151515231.0303030362.06060606124.1212121248.2424242 71031.0303030362.06060606124.1212121248.2424242496.4848485 81162.06060606124.1212121248.2424242496.4848485992.969697 912124.1212121248.2424242496.4848485992.9696971985.9393941013248.2424242496.4848485992.9696971985.9393943971.8787881114496.4848485992.9696971985.9393943971.8787887943.7575761215992.9696971985.9393943971.8787887943.75757615887.5151513161985.9393943971.8787887943.75757615887.5151531775.030314173971.8787887943.75757615887.5151531775.030363550.06061 <p>How good is the file_reader?</p> <p>I've included all formats in the test suite that are publicly available from the Alan Turing institute, dateutils) and Python's csv reader.</p> <p>What about <code>MM-DD-YYYY</code> formats? Some users from the US ask why the csv reader doesn't read the month-day-year format.</p> <p>The answer is simple: It's not an iso8601 format. The US month-day-year format is a locale that may be used a lot in the US, but it isn't an international standard.</p> <p>If you need to work with <code>MM-DD-YYYY</code> you will find that the file_reader will import the values as text (str). You can then reformat it with a custom function like:</p> In\u00a0[69]: Copied! <pre>s = \"03-21-1998\"\nfrom datetime import date\nf = lambda s: date(int(s[-4:]), int(s[:2]), int(s[3:5]))\nf(s)\n</pre> s = \"03-21-1998\" from datetime import date f = lambda s: date(int(s[-4:]), int(s[:2]), int(s[3:5])) f(s) Out[69]: <pre>datetime.date(1998, 3, 21)</pre> In\u00a0[70]: Copied! <pre>from tablite.import_utils import file_readers\nfor k,v in file_readers.items():\n    print(k,v)\n</pre> from tablite.import_utils import file_readers for k,v in file_readers.items():     print(k,v) <pre>fods &lt;function excel_reader at 0x7f36a3ef8c10&gt;\njson &lt;function excel_reader at 0x7f36a3ef8c10&gt;\nhtml &lt;function from_html at 0x7f36a3ef8b80&gt;\nhdf5 &lt;function from_hdf5 at 0x7f36a3ef8a60&gt;\nsimple &lt;function excel_reader at 0x7f36a3ef8c10&gt;\nrst &lt;function excel_reader at 0x7f36a3ef8c10&gt;\nmediawiki &lt;function excel_reader at 0x7f36a3ef8c10&gt;\nxlsx &lt;function excel_reader at 0x7f36a3ef8c10&gt;\nxls &lt;function excel_reader at 0x7f36a3ef8c10&gt;\nxlsm &lt;function excel_reader at 0x7f36a3ef8c10&gt;\ncsv &lt;function text_reader at 0x7f36a3ef9000&gt;\ntsv &lt;function text_reader at 0x7f36a3ef9000&gt;\ntxt &lt;function text_reader at 0x7f36a3ef9000&gt;\nods &lt;function ods_reader at 0x7f36a3ef8ca0&gt;\n</pre> <p>(2) define your new file reader</p> In\u00a0[71]: Copied! <pre>def my_magic_reader(path, **kwargs):   # define your new file reader.\n    print(\"do magic with {path}\")\n    return\n</pre> def my_magic_reader(path, **kwargs):   # define your new file reader.     print(\"do magic with {path}\")     return <p>(3) add it to the list of readers.</p> In\u00a0[72]: Copied! <pre>file_readers['my_special_format'] = my_magic_reader\n</pre> file_readers['my_special_format'] = my_magic_reader <p>The <code>file_readers</code> are all in tablite.core so if you intend to extend the readers, I recommend that you start here.</p> In\u00a0[73]: Copied! <pre>file = Path('example.xlsx')\ntx2.to_xlsx(file)\nos.remove(file)\n</pre> file = Path('example.xlsx') tx2.to_xlsx(file) os.remove(file) <p></p> In\u00a0[74]: Copied! <pre>from tablite import Table\n\nt = Table({\n'a':[1, 2, 8, 3, 4, 6, 5, 7, 9],\n'b':[10, 100, 3, 4, 16, -1, 10, 10, 10],\n})\nt.sort(mapping={\"a\":False})\nt\n</pre> from tablite import Table  t = Table({ 'a':[1, 2, 8, 3, 4, 6, 5, 7, 9], 'b':[10, 100, 3, 4, 16, -1, 10, 10, 10], }) t.sort(mapping={\"a\":False}) t <pre>creating sort index: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 1/1 [00:00&lt;00:00, 1674.37it/s]\njoin: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 2/2 [00:00&lt;00:00, 1701.89it/s]\n</pre> Out[74]: #ab 0110 12100 234 3416 4510 56-1 6710 783 8910 In\u00a0[75]: Copied! <pre>%pip install matplotlib -q\n</pre> %pip install matplotlib -q <pre>Note: you may need to restart the kernel to use updated packages.\n</pre> In\u00a0[76]: Copied! <pre>import matplotlib.pyplot as plt\nplt.plot(t['a'], t['b'])\nplt.ylabel('Hello Figure')\nplt.show()\n</pre> import matplotlib.pyplot as plt plt.plot(t['a'], t['b']) plt.ylabel('Hello Figure') plt.show() In\u00a0[77]: Copied! <pre>## Let's monitor the memory and record the observations into a table!\nimport psutil, os, gc\nfrom time import process_time,sleep\nprocess = psutil.Process(os.getpid())\n\ndef mem_time():  # go and check taskmanagers memory usage.\n    return process.memory_info().rss, process_time()\n\ndigits = 1_000_000\n\nrecords = Table({'method':[], 'memory':[], 'time':[]})\n</pre> ## Let's monitor the memory and record the observations into a table! import psutil, os, gc from time import process_time,sleep process = psutil.Process(os.getpid())  def mem_time():  # go and check taskmanagers memory usage.     return process.memory_info().rss, process_time()  digits = 1_000_000  records = Table({'method':[], 'memory':[], 'time':[]})  <p>The row based format: 1 million 10-tuples</p> In\u00a0[78]: Copied! <pre>before, start = mem_time()\nL = [tuple([11 for _ in range(10)]) for _ in range(digits)]\nafter, end = mem_time()  \ndel L\ngc.collect()\n\nrecords.add_rows(*('1e6 lists w. 10 integers', after - before, round(end-start,4)))\nrecords\n</pre> before, start = mem_time() L = [tuple([11 for _ in range(10)]) for _ in range(digits)] after, end = mem_time()   del L gc.collect()  records.add_rows(*('1e6 lists w. 10 integers', after - before, round(end-start,4))) records Out[78]: #methodmemorytime 01e6 lists w. 10 integers1190543360.5045 <p>The column based format: 10 columns with 1M values:</p> In\u00a0[79]: Copied! <pre>before, start = mem_time()\nL = [[11 for i2 in range(digits)] for i1 in range(10)]\nafter,end = mem_time()\n\ndel L\ngc.collect()\nrecords.add_rows(('10 lists with 1e6 integers', after - before, round(end-start,4)))\n</pre> before, start = mem_time() L = [[11 for i2 in range(digits)] for i1 in range(10)] after,end = mem_time()  del L gc.collect() records.add_rows(('10 lists with 1e6 integers', after - before, round(end-start,4))) <p>We've thereby saved 50 Mb by avoiding the overhead from managing 1 million lists.</p> <p>Q: But why didn't I just use an array? It would have even lower memory footprint.</p> <p>A: First, array's don't handle None's and we get that frequently in dirty csv data.</p> <p>Second, Table needs even less memory.</p> <p>Let's try with an array:</p> In\u00a0[80]: Copied! <pre>import array\n\nbefore, start = mem_time()\nL = [array.array('i', [11 for _ in range(digits)]) for _ in range(10)]\nafter,end = mem_time()\n\ndel L\ngc.collect()\nrecords.add_rows(('10 lists with 1e6 integers in arrays', after - before, round(end-start,4)))\nrecords\n</pre> import array  before, start = mem_time() L = [array.array('i', [11 for _ in range(digits)]) for _ in range(10)] after,end = mem_time()  del L gc.collect() records.add_rows(('10 lists with 1e6 integers in arrays', after - before, round(end-start,4))) records Out[80]: #methodmemorytime 01e6 lists w. 10 integers1190543360.5045 110 lists with 1e6 integers752762880.1906 210 lists with 1e6 integers in arrays398336000.3633 <p>Finally let's use a <code>tablite.Table</code>:</p> In\u00a0[81]: Copied! <pre>before,start = mem_time()\nt = Table(columns={str(i1): [11 for i2 in range(digits)] for i1 in range(10)})\nafter,end = mem_time()\n\nrecords.add_rows(('Table with 10 columns with 1e6 integers', after - before, round(end-start,4)))\n\nbefore,start = mem_time()\nt2 = t.copy()\nafter,end = mem_time()\n\nrecords.add_rows(('2 Tables with 10 columns with 1e6 integers each', after - before, round(end-start,4)))\n\n## Let's show it, so we know nobody's cheating:\nt2\n</pre> before,start = mem_time() t = Table(columns={str(i1): [11 for i2 in range(digits)] for i1 in range(10)}) after,end = mem_time()  records.add_rows(('Table with 10 columns with 1e6 integers', after - before, round(end-start,4)))  before,start = mem_time() t2 = t.copy() after,end = mem_time()  records.add_rows(('2 Tables with 10 columns with 1e6 integers each', after - before, round(end-start,4)))  ## Let's show it, so we know nobody's cheating: t2  Out[81]: #0123456789        011111111111111111111        111111111111111111111        211111111111111111111        311111111111111111111        411111111111111111111        511111111111111111111        611111111111111111111.................................  999,99311111111111111111111  999,99411111111111111111111  999,99511111111111111111111  999,99611111111111111111111  999,99711111111111111111111  999,99811111111111111111111  999,99911111111111111111111 In\u00a0[82]: Copied! <pre>records\n</pre> records Out[82]: #methodmemorytime 01e6 lists w. 10 integers1190543360.5045 110 lists with 1e6 integers752762880.1906 210 lists with 1e6 integers in arrays398336000.3633 3Table with 10 columns with 1e6 integers01.9569 42 Tables with 10 columns with 1e6 integers each00.0001 <p>Conclusion: whilst the common worst case (1M lists with 10 integers) take up 118 Mb of RAM, Tablite's tables vanish in the noise of memory measurement.</p> <p>Pandas also permits the usage of namedtuples, which are unpacked upon entry.</p> <pre>from collections import namedtuple\nPoint = namedtuple(\"Point\", \"x y\")\npoints = [Point(0, 0), Point(0, 3)]\npd.DataFrame(points)\n</pre> <p>Doing that in tablite is a bit different. To unpack the named tuple, you should do so explicitly:</p> <pre>t = Table({'x': [p.x for p in points], 'y': [p.y for p in points]})\n</pre> <p>However should you want to keep the points as namedtuple, you can do so in tablite:</p> <pre>t = Table()\nt['points'] = points\n</pre> <p>Tablite will store a serialised version of the points, so your memory overhead will be close to zero.</p>"},{"location":"tutorial/#tablite","title":"Tablite\u00b6","text":""},{"location":"tutorial/#introduction","title":"Introduction\u00b6","text":"<p>Tablite fills the data-science space where incremental data processing based on:</p> <ul> <li>Datasets are larger than memory.</li> <li>You don't want to worry about datatypes.</li> </ul> <p>Tablite thereby competes with:</p> <ul> <li>Pandas, but saves the memory overhead.</li> <li>Numpy, but spares you from worrying about lower level data types</li> <li>SQlite, by sheer speed.</li> <li>Polars, by working beyond RAM.</li> <li>Other libraries for data cleaning thanks to tablites powerful <code>datatypes</code> module.</li> </ul> <p>Install: <code>pip install tablite</code></p> <p>Usage:  <code>&gt;&gt;&gt; from tablite import Table</code></p> <p>Upgrade: <code>pip install tablite --no-cache --upgrade</code></p>"},{"location":"tutorial/#overview","title":"Overview\u00b6","text":"<p>(Version 2023.6.0 and later. For older version see this)</p> <ul> <li>Tablite handles all Python datatypes: <code>str</code>, <code>float</code>, <code>bool</code>, <code>int</code>, <code>date</code>, <code>datetime</code>, <code>time</code>, <code>timedelta</code> and <code>None</code>.</li> <li>you can select:<ul> <li>all rows in a column as <code>table['A']</code></li> <li>rows across all columns as <code>table[4:8]</code></li> <li>or a slice as <code>table['A', 'B', slice(4,8) ]</code>.</li> </ul> </li> <li>you to update with <code>table['A'][2] = new value</code></li> <li>you can store or send data using json, by:<ul> <li>dumping to json: <code>json_str = table.to_json()</code>, or</li> <li>you can load it with <code>Table.from_json(json_str)</code>.</li> </ul> </li> <li>you can iterate over rows using <code>for row in Table.rows</code>.</li> <li>you can ask <code>column_xyz in Table.colums</code> ?</li> <li>load from files with <code>new_table = Table.from_file('this.csv')</code> which has automatic datatype detection</li> <li>perform inner, outer &amp; left sql join between tables as simple as <code>table_1.inner_join(table2, keys=['A', 'B'])</code></li> <li>summarise using <code>table.groupby( ... )</code></li> <li>create pivot tables using <code>groupby.pivot( ... )</code></li> <li>perform multi-criteria lookup in tables using <code>table1.lookup(table2, criteria=.....</code></li> <li>and of course a large selection of tools in <code>from tablite.tools import *</code></li> </ul>"},{"location":"tutorial/#examples","title":"Examples\u00b6","text":"<p>Here are some examples:</p>"},{"location":"tutorial/#api-examples","title":"API Examples\u00b6","text":"<p>In the following sections, example are given of the Tablite API's power features:</p> <ul> <li>Iteration</li> <li>Append</li> <li>Sort</li> <li>Filter</li> <li>Index</li> <li>Search All</li> <li>Search Any</li> <li>Lookup</li> <li>Join inner, outer,</li> <li>GroupBy</li> <li>Pivot table</li> </ul>"},{"location":"tutorial/#iteration","title":"ITERATION!\u00b6","text":"<p>Iteration supports for loops and list comprehension at the speed of light:</p> <p>Just use <code>[r for r in table.rows]</code>, or:</p> <pre><code>for row in table.rows:\n    row ...</code></pre> <p>Here's a more practical use case:</p> <p>(1) Imagine a table with columns a,b,c,d,e (all integers) like this:</p>"},{"location":"tutorial/#create-index-indices","title":"Create Index / Indices\u00b6","text":"<p>Index supports multi-key indexing using args such as: <code>index = table.index('B','C')</code>.</p> <p>Here's an example:</p>"},{"location":"tutorial/#append","title":"APPEND\u00b6","text":""},{"location":"tutorial/#save","title":"SAVE\u00b6","text":""},{"location":"tutorial/#filter","title":"FILTER!\u00b6","text":""},{"location":"tutorial/#any-all","title":"Any! All?\u00b6","text":"<p>Any and All are cousins of the filter. They're there so you can use them in the same way as you'd use <code>any</code> and <code>all</code> in python - as boolean evaluators:</p>"},{"location":"tutorial/#sort","title":"SORT!\u00b6","text":""},{"location":"tutorial/#groupby","title":"GROUPBY !\u00b6","text":""},{"location":"tutorial/#did-i-say-pivot-table-yes","title":"Did I say pivot table? Yes.\u00b6","text":"<p>Pivot Table is included in the groupby functionality - so yes - you can pivot the groupby on any column that is used for grouping. Here's a simple example:</p>"},{"location":"tutorial/#join","title":"JOIN!\u00b6","text":""},{"location":"tutorial/#lookup","title":"LOOKUP!\u00b6","text":""},{"location":"tutorial/#match","title":"Match\u00b6","text":"<p>If you're looking to do a join where you afterwards remove the empty rows, <code>match</code> is the faster choice.</p> <p>Here is an example.</p> <p>Let's start with two tables:</p>"},{"location":"tutorial/#are-there-other-ways-i-can-add-data","title":"Are there other ways I can add data?\u00b6","text":"<p>Yes - but row based operations cause a lot of IO, so it'll work but be slower:</p>"},{"location":"tutorial/#okay-great-how-do-i-load-data","title":"Okay, great. How do I load data?\u00b6","text":"<p>Easy. Use <code>file_reader</code>. Here's an example:</p>"},{"location":"tutorial/#sweet-what-formats-are-supported-can-i-add-my-own-file-reader","title":"Sweet. What formats are supported? Can I add my own file reader?\u00b6","text":"<p>Yes! This is very good for special log files or custom json formats. Here's how you do it:</p> <p>(1) Go to all existing readers in the <code>tablite.core</code> and find the closest match.</p>"},{"location":"tutorial/#very-nice-how-about-exporting-data","title":"Very nice. How about exporting data?\u00b6","text":"<p>Just use .export</p>"},{"location":"tutorial/#cool-does-it-play-well-with-plotting-packages","title":"Cool. Does it play well with plotting packages?\u00b6","text":"<p>Yes. Here's an example you can copy and paste:</p>"},{"location":"tutorial/#i-like-sql-can-tablite-understand-sql","title":"I like sql. Can tablite understand SQL?\u00b6","text":"<p>Almost. You can use <code>table.to_sql</code> and tablite will return ANSI-92 compliant SQL.</p> <p>You can also create a table using <code>Table.from_sql</code> and tablite will consume ANSI-92 compliant SQL.</p>"},{"location":"tutorial/#but-what-do-i-do-if-im-about-to-run-out-of-memory","title":"But what do I do if I'm about to run out of memory?\u00b6","text":"<p>You wont. Every tablite table is backed by disk. The memory footprint of a table is only the metadata required to know the relationships between variable names and the datastructures.</p> <p>Let's do a comparison:</p>"},{"location":"tutorial/#conclusions","title":"Conclusions\u00b6","text":"<p>This concludes the mega-tutorial to <code>tablite</code>. There's nothing more to it. But oh boy it'll save a lot of time.</p> <p>Here's a summary of features:</p> <ul> <li>Everything a list can do.</li> <li>import csv*, fods, json, html, simple, rst, mediawiki, xlsx, xls, xlsm, csv, tsv, txt, ods using <code>Table.from_file(...)</code></li> <li>Iterate over rows or columns</li> <li>Create multikey <code>index</code>, <code>sort</code>, use <code>filter</code>, <code>any</code> and <code>all</code> to select. Perform <code>lookup</code> across tables including using custom functions.</li> <li>Perform multikey <code>joins</code> with other tables.</li> <li>Perform <code>groupby</code> and reorganise data as a <code>pivot</code> table with max, min, sum, first, last, count, unique, average, standard deviation, median and mode.</li> <li>Update tables with <code>+=</code> which automatically sorts out the columns - even if they're not in perfect order.</li> </ul>"},{"location":"tutorial/#faq","title":"FAQ\u00b6","text":"Question Answer I'm not in a notebook. Is there a nice way to view tables? Yes. <code>table.show()</code> prints the ascii version I'm looking for the equivalent to <code>apply</code> in pandas. Just use list comprehensions: <code>table[column] = [f(x) for x in table[column]</code> What about <code>map</code>? Just use the python function: <code>mapping = map(f, table[column name])</code> Is there a <code>where</code> function? It's called <code>any</code> or <code>all</code> like in python: <code>table.any(column_name &gt; 0)</code>. I like sql and sqlite. Can I use sql? Yes. Call <code>table.to_sql()</code> returns ANSI-92 SQL compliant table definition.You can use this in any SQL compliant engine. <p>| sometimes i need to clean up data with datetimes. Is there any tool to help with that? | Yes. Look at DataTypes.<code>DataTypes.round(value, multiple)</code> allows rounding of datetime.</p>"},{"location":"tutorial/#coming-to-tablite-from-pandas","title":"Coming to Tablite from Pandas\u00b6","text":"<p>If you're coming to Tablite from Pandas you will notice some differences.</p> <p>Here's the ultra short comparison to the documentation from Pandas called 10 minutes intro to pandas</p> <p>The tutorials provide the generic overview:</p> <ul> <li>pandas tutorial</li> <li>tablite tutorial</li> </ul> <p>Some key differences</p> topic Tablite Viewing data Just use <code>table.show()</code> in print outs, or if you're in a jupyter notebook just use the variable name <code>table</code> Selection Slicing works both on columns and rows, and you can filter using <code>any</code> or <code>all</code>:<code>table['A','B', 2:30:3].any(A=lambda x:x&gt;3)</code> to copy a table use: <code>t2 = t.copy()</code>This is a very fast deep copy, that has no memory overhead as tablites memory manager keeps track of the data. Missing data Tablite uses <code>mixed</code> column format for any format that isn't uniformTo get rid of rows with <code>None</code>s and <code>np.nan</code>s use any:<code>table.drop_na(None, np.nan)</code> Alternatively you can use replace: <code>table.replace(None,5)</code> following the syntax: <code>table.replace_missing_values(sources, target)</code> Operations Descriptive statistics are on a colum by column basis:<code>table['a'].statistics()</code>  the pandas function <code>df.apply</code> doesn't exist in tablite. Use a list comprehension instead. For example: <code>df.apply(np.cumsum)</code> is just <code>np.cumsum(t['A'])</code>  \"histogramming\" in tablite is per column: <code>table['a'].histogram()</code>  string methods? Just use a list comprehensions: <code>table['A', 'B'].any(A=lambda x: \"hello\" in x, B=lambda x: \"world\" in x)</code> Merge Concatenation: Just use <code>+</code> or <code>+=</code> as in <code>t1 = t2 + t3 += t4</code>. If the columns are out of order, tablite will sort the headers according to the order in the first table.If you're worried that the header mismatch use <code>t1.stack(t2)</code>  Joins are ANSI92 compliant: <code>t1.join(t2, &lt;...args...&gt;, join_type=...)</code>. Grouping Tablite supports multikey groupby using <code>from tablite import Groupby as gb</code>. <code>table.groupby(keys, functions)</code> Reshaping To reshape a table use <code>transpose</code>.  to perform pivot table like operations, use: <code>table.pivot(rows, columns, functions)</code> subtotals aside tablite will give you everything Excels pivot table can do. Time series To convert time series use a list comprehension.<code>t1['GMT'] = [timedelta(hours=1) + v for v in t1['date'] ]</code>  to generate a date range use:<code>from Tablite import daterange</code><code>t['date'] = date_range(start=2022/1/1, stop=2023/1/1, step=timedelta(days=1))</code> Categorical Pandas only seems to use this for sorting and grouping.  Tablite table has <code>.sort</code>, <code>.groupby</code> and <code>.pivot</code>  to achieve the same task. Plotting Import your favorite plotting package and feed it the values, such as:<code>import matplotlib.pyplot as plt</code> <code>plt.plot(t['a'],t['b'])</code> <code>plt.showw()</code> Import/Export Tablite supports the same import/export options as pandas.Tablite pegs the free memory before IO and can therefore process larger-than-RAM files. Tablite also guesses the datatypes for all ISOformats and uses multiprocessing and may therefore be faster. Should you want to inspect how guess works, use <code>from tools import guess</code> and try the function out. Gotchas None really. Should you come across something non-pythonic, then please post it on the issue list."},{"location":"reference/base/","title":"Base","text":""},{"location":"reference/base/#tablite.base","title":"<code>tablite.base</code>","text":""},{"location":"reference/base/#tablite.base-attributes","title":"Attributes","text":""},{"location":"reference/base/#tablite.base.log","title":"<code>tablite.base.log = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/base/#tablite.base.file_registry","title":"<code>tablite.base.file_registry = set()</code>  <code>module-attribute</code>","text":""},{"location":"reference/base/#tablite.base-classes","title":"Classes","text":""},{"location":"reference/base/#tablite.base.SimplePage","title":"<code>tablite.base.SimplePage(id, path, len, py_dtype)</code>","text":"<p>             Bases: <code>object</code></p> Source code in <code>tablite/base.py</code> <pre><code>def __init__(self, id, path, len, py_dtype) -&gt; None:\n    self.path = Path(path) / \"pages\" / f\"{id}.npy\"\n    self.len = len\n    self.dtype = py_dtype\n\n    self._incr_refcount()\n</code></pre>"},{"location":"reference/base/#tablite.base.SimplePage-attributes","title":"Attributes","text":""},{"location":"reference/base/#tablite.base.SimplePage.ids","title":"<code>tablite.base.SimplePage.ids = count(start=1)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.SimplePage.refcounts","title":"<code>tablite.base.SimplePage.refcounts = {}</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.SimplePage.autocleanup","title":"<code>tablite.base.SimplePage.autocleanup = True</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.SimplePage.path","title":"<code>tablite.base.SimplePage.path = Path(path) / 'pages' / f'{id}.npy'</code>  <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.SimplePage.len","title":"<code>tablite.base.SimplePage.len = len</code>  <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.SimplePage.dtype","title":"<code>tablite.base.SimplePage.dtype = py_dtype</code>  <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.SimplePage-functions","title":"Functions","text":""},{"location":"reference/base/#tablite.base.SimplePage.__setstate__","title":"<code>tablite.base.SimplePage.__setstate__(state)</code>","text":"<p>when an object is unpickled, say in a case of multi-processing, object.setstate(state) is called instead of init, this means we need to update page refcount as if constructor had been called</p> Source code in <code>tablite/base.py</code> <pre><code>def __setstate__(self, state):\n    \"\"\"\n    when an object is unpickled, say in a case of multi-processing,\n    object.__setstate__(state) is called instead of __init__, this means\n    we need to update page refcount as if constructor had been called\n    \"\"\"\n    self.__dict__.update(state)\n\n    self._incr_refcount()\n</code></pre>"},{"location":"reference/base/#tablite.base.SimplePage.next_id","title":"<code>tablite.base.SimplePage.next_id(path)</code>  <code>classmethod</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>@classmethod\ndef next_id(cls, path):\n    path = Path(path)\n\n    while True:\n        _id = f\"{os.getpid()}-{next(cls.ids)}\"\n        _path = path / \"pages\" / f\"{_id}.npy\"\n\n        if not _path.exists():\n            break  # make sure we don't override existing pages if they are created outside of main thread\n\n    return _id\n</code></pre>"},{"location":"reference/base/#tablite.base.SimplePage.__len__","title":"<code>tablite.base.SimplePage.__len__()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __len__(self):\n    return self.len\n</code></pre>"},{"location":"reference/base/#tablite.base.SimplePage.__repr__","title":"<code>tablite.base.SimplePage.__repr__() -&gt; str</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __repr__(self) -&gt; str:\n    try:\n        return f\"{self.__class__.__name__}({self.path}, {self.get()})\"\n    except FileNotFoundError as e:\n        return f\"{self.__class__.__name__}({self.path}, &lt;{type(e).__name__}&gt;)\"\n    except Exception as e:\n        return f\"{self.__class__.__name__}({self.path}, &lt;{e}&gt;)\"\n</code></pre>"},{"location":"reference/base/#tablite.base.SimplePage.__hash__","title":"<code>tablite.base.SimplePage.__hash__() -&gt; int</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __hash__(self) -&gt; int:\n    return hash(self.path)\n</code></pre>"},{"location":"reference/base/#tablite.base.SimplePage.owns","title":"<code>tablite.base.SimplePage.owns()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def owns(self):\n    parts = self.path.parts\n\n    return all((p in parts for p in Path(Config.pid).parts))\n</code></pre>"},{"location":"reference/base/#tablite.base.SimplePage.__del__","title":"<code>tablite.base.SimplePage.__del__()</code>","text":"<p>When python's reference count for an object is 0, python uses it's garbage collector to remove the object and free the memory. As tablite tables have columns and columns have page and pages have data stored on disk, the space on disk must be freed up as well. This del override assures the cleanup of stored data.</p> Source code in <code>tablite/base.py</code> <pre><code>def __del__(self):\n    \"\"\"When python's reference count for an object is 0, python uses\n    it's garbage collector to remove the object and free the memory.\n    As tablite tables have columns and columns have page and pages have\n    data stored on disk, the space on disk must be freed up as well.\n    This __del__ override assures the cleanup of stored data.\n    \"\"\"\n    if not self.owns():\n        return\n\n    refcount = self.refcounts[self.path] = max(\n        self.refcounts.get(self.path, 0) - 1, 0\n    )\n\n    if refcount &gt; 0:\n        return\n\n    if self.autocleanup:\n        self.path.unlink(True)\n\n    del self.refcounts[self.path]\n</code></pre>"},{"location":"reference/base/#tablite.base.SimplePage.get","title":"<code>tablite.base.SimplePage.get()</code>","text":"<p>loads stored data</p> RETURNS DESCRIPTION <p>np.ndarray: stored data.</p> Source code in <code>tablite/base.py</code> <pre><code>def get(self):\n    \"\"\"loads stored data\n\n    Returns:\n        np.ndarray: stored data.\n    \"\"\"\n    array = load_numpy(self.path)\n    return MetaArray(array, array.dtype, py_dtype=self.dtype)\n</code></pre>"},{"location":"reference/base/#tablite.base.Page","title":"<code>tablite.base.Page(path, array)</code>","text":"<p>             Bases: <code>SimplePage</code></p> PARAMETER  DESCRIPTION <code>path</code> <p>working directory.</p> <p> TYPE: <code>Path</code> </p> <code>array</code> <p>data</p> <p> TYPE: <code>array</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def __init__(self, path, array) -&gt; None:\n    \"\"\"\n    Args:\n        path (Path): working directory.\n        array (np.array): data\n    \"\"\"\n    _id = self.next_id(path)\n\n    type_check(array, np.ndarray)\n\n    if Config.DISK_LIMIT &lt;= 0:\n        pass\n    else:\n        _, _, free = shutil.disk_usage(path)\n        if free - array.nbytes &lt; Config.DISK_LIMIT:\n            msg = \"\\n\".join(\n                [\n                    f\"Disk limit reached: Config.DISK_LIMIT = {Config.DISK_LIMIT:,} bytes.\",\n                    f\"array requires {array.nbytes:,} bytes, but only {free:,} bytes are free.\",\n                    \"To disable this check, use:\",\n                    \"&gt;&gt;&gt; from tablite.config import Config\",\n                    \"&gt;&gt;&gt; Config.DISK_LIMIT = 0\",\n                    \"To free space, clean up Config.workdir:\",\n                    f\"{Config.workdir}\",\n                ]\n            )\n            raise OSError(msg)\n\n    _len = len(array)\n    # type_check(array, MetaArray)\n    if not hasattr(array, \"metadata\"):\n        raise ValueError\n    _dtype = array.metadata[\"py_dtype\"]\n\n    super().__init__(_id, path, _len, _dtype)\n\n    np.save(self.path, array, allow_pickle=True, fix_imports=False)\n    log.debug(f\"Page saved: {self.path}\")\n</code></pre>"},{"location":"reference/base/#tablite.base.Page-attributes","title":"Attributes","text":""},{"location":"reference/base/#tablite.base.Page.ids","title":"<code>tablite.base.Page.ids = count(start=1)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.Page.refcounts","title":"<code>tablite.base.Page.refcounts = {}</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.Page.autocleanup","title":"<code>tablite.base.Page.autocleanup = True</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.Page.path","title":"<code>tablite.base.Page.path = Path(path) / 'pages' / f'{id}.npy'</code>  <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.Page.len","title":"<code>tablite.base.Page.len = len</code>  <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.Page.dtype","title":"<code>tablite.base.Page.dtype = py_dtype</code>  <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.Page-functions","title":"Functions","text":""},{"location":"reference/base/#tablite.base.Page.__setstate__","title":"<code>tablite.base.Page.__setstate__(state)</code>","text":"<p>when an object is unpickled, say in a case of multi-processing, object.setstate(state) is called instead of init, this means we need to update page refcount as if constructor had been called</p> Source code in <code>tablite/base.py</code> <pre><code>def __setstate__(self, state):\n    \"\"\"\n    when an object is unpickled, say in a case of multi-processing,\n    object.__setstate__(state) is called instead of __init__, this means\n    we need to update page refcount as if constructor had been called\n    \"\"\"\n    self.__dict__.update(state)\n\n    self._incr_refcount()\n</code></pre>"},{"location":"reference/base/#tablite.base.Page.next_id","title":"<code>tablite.base.Page.next_id(path)</code>  <code>classmethod</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>@classmethod\ndef next_id(cls, path):\n    path = Path(path)\n\n    while True:\n        _id = f\"{os.getpid()}-{next(cls.ids)}\"\n        _path = path / \"pages\" / f\"{_id}.npy\"\n\n        if not _path.exists():\n            break  # make sure we don't override existing pages if they are created outside of main thread\n\n    return _id\n</code></pre>"},{"location":"reference/base/#tablite.base.Page.__len__","title":"<code>tablite.base.Page.__len__()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __len__(self):\n    return self.len\n</code></pre>"},{"location":"reference/base/#tablite.base.Page.__repr__","title":"<code>tablite.base.Page.__repr__() -&gt; str</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __repr__(self) -&gt; str:\n    try:\n        return f\"{self.__class__.__name__}({self.path}, {self.get()})\"\n    except FileNotFoundError as e:\n        return f\"{self.__class__.__name__}({self.path}, &lt;{type(e).__name__}&gt;)\"\n    except Exception as e:\n        return f\"{self.__class__.__name__}({self.path}, &lt;{e}&gt;)\"\n</code></pre>"},{"location":"reference/base/#tablite.base.Page.__hash__","title":"<code>tablite.base.Page.__hash__() -&gt; int</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __hash__(self) -&gt; int:\n    return hash(self.path)\n</code></pre>"},{"location":"reference/base/#tablite.base.Page.owns","title":"<code>tablite.base.Page.owns()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def owns(self):\n    parts = self.path.parts\n\n    return all((p in parts for p in Path(Config.pid).parts))\n</code></pre>"},{"location":"reference/base/#tablite.base.Page.__del__","title":"<code>tablite.base.Page.__del__()</code>","text":"<p>When python's reference count for an object is 0, python uses it's garbage collector to remove the object and free the memory. As tablite tables have columns and columns have page and pages have data stored on disk, the space on disk must be freed up as well. This del override assures the cleanup of stored data.</p> Source code in <code>tablite/base.py</code> <pre><code>def __del__(self):\n    \"\"\"When python's reference count for an object is 0, python uses\n    it's garbage collector to remove the object and free the memory.\n    As tablite tables have columns and columns have page and pages have\n    data stored on disk, the space on disk must be freed up as well.\n    This __del__ override assures the cleanup of stored data.\n    \"\"\"\n    if not self.owns():\n        return\n\n    refcount = self.refcounts[self.path] = max(\n        self.refcounts.get(self.path, 0) - 1, 0\n    )\n\n    if refcount &gt; 0:\n        return\n\n    if self.autocleanup:\n        self.path.unlink(True)\n\n    del self.refcounts[self.path]\n</code></pre>"},{"location":"reference/base/#tablite.base.Page.get","title":"<code>tablite.base.Page.get()</code>","text":"<p>loads stored data</p> RETURNS DESCRIPTION <p>np.ndarray: stored data.</p> Source code in <code>tablite/base.py</code> <pre><code>def get(self):\n    \"\"\"loads stored data\n\n    Returns:\n        np.ndarray: stored data.\n    \"\"\"\n    array = load_numpy(self.path)\n    return MetaArray(array, array.dtype, py_dtype=self.dtype)\n</code></pre>"},{"location":"reference/base/#tablite.base.Column","title":"<code>tablite.base.Column(path, value=None)</code>","text":"<p>             Bases: <code>object</code></p> <p>Create Column</p> PARAMETER  DESCRIPTION <code>path</code> <p>path of table.yml (defaults: Config.pid_dir)</p> <p> TYPE: <code>Path</code> </p> <code>value</code> <p>Data to store. Defaults to None.</p> <p> TYPE: <code>Iterable</code> DEFAULT: <code>None</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def __init__(self, path, value=None) -&gt; None:\n    \"\"\"Create Column\n\n    Args:\n        path (Path): path of table.yml (defaults: Config.pid_dir)\n        value (Iterable, optional): Data to store. Defaults to None.\n    \"\"\"\n    self.path = path\n    self.pages = []  # keeps pointers to instances of Page\n    if value is not None:\n        self.extend(value)\n</code></pre>"},{"location":"reference/base/#tablite.base.Column-attributes","title":"Attributes","text":""},{"location":"reference/base/#tablite.base.Column.path","title":"<code>tablite.base.Column.path = path</code>  <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.Column.pages","title":"<code>tablite.base.Column.pages = []</code>  <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.Column-functions","title":"Functions","text":""},{"location":"reference/base/#tablite.base.Column.__len__","title":"<code>tablite.base.Column.__len__()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __len__(self):\n    return sum(len(p) for p in self.pages)\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__repr__","title":"<code>tablite.base.Column.__repr__()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __repr__(self):\n    return f\"{self.__class__.__name__}({self.path}, {self[:]})\"\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.repaginate","title":"<code>tablite.base.Column.repaginate()</code>","text":"<p>resizes pages to Config.PAGE_SIZE</p> Source code in <code>tablite/base.py</code> <pre><code>def repaginate(self):\n    \"\"\"resizes pages to Config.PAGE_SIZE\"\"\"\n    from tablite.nimlite import repaginate as _repaginate\n\n    _repaginate(self)\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.extend","title":"<code>tablite.base.Column.extend(value)</code>","text":"<p>extends the column.</p> PARAMETER  DESCRIPTION <code>value</code> <p>data</p> <p> TYPE: <code>ndarray</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def extend(self, value):  # USER FUNCTION.\n    \"\"\"extends the column.\n\n    Args:\n        value (np.ndarray): data\n    \"\"\"\n    if isinstance(value, Column):\n        self.pages.extend(value.pages[:])\n        return\n    elif isinstance(value, np.ndarray):\n        pass\n    elif isinstance(value, (list, tuple)):\n        value = list_to_np_array(value)\n    else:\n        raise TypeError(f\"Cannot extend Column with {type(value)}\")\n    type_check(value, np.ndarray)\n    for array in self._paginate(value):\n        self.pages.append(Page(path=self.path, array=array))\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.clear","title":"<code>tablite.base.Column.clear()</code>","text":"<p>clears the column. Like list().clear()</p> Source code in <code>tablite/base.py</code> <pre><code>def clear(self):\n    \"\"\"\n    clears the column. Like list().clear()\n    \"\"\"\n    self.pages.clear()\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.getpages","title":"<code>tablite.base.Column.getpages(item)</code>","text":"<p>public non-user function to identify any pages + slices of data to be retrieved given a slice (item)</p> PARAMETER  DESCRIPTION <code>item</code> <p>target slice of data</p> <p> TYPE: <code>(int, slice)</code> </p> RETURNS DESCRIPTION <p>list of pages/np.ndarrays.</p> <p>Example: [Page(1), Page(2), np.ndarray([4,5,6], int64)] This helps, for example when creating a copy, as the copy can reference the pages 1 and 2 and only need to store the np.ndarray that is unique to it.</p> Source code in <code>tablite/base.py</code> <pre><code>def getpages(self, item):\n    \"\"\"public non-user function to identify any pages + slices\n    of data to be retrieved given a slice (item)\n\n    Args:\n        item (int,slice): target slice of data\n\n    Returns:\n        list of pages/np.ndarrays.\n\n    Example: [Page(1), Page(2), np.ndarray([4,5,6], int64)]\n    This helps, for example when creating a copy, as the copy\n    can reference the pages 1 and 2 and only need to store\n    the np.ndarray that is unique to it.\n    \"\"\"\n    # internal function\n    if isinstance(item, int):\n        if item &lt; 0:\n            item = len(self) + item\n        item = slice(item, item + 1, 1)\n\n    type_check(item, slice)\n    is_reversed = False if (item.step is None or item.step &gt; 0) else True\n\n    length = len(self)\n    scan_item = slice(*item.indices(length))\n    range_item = range(*item.indices(length))\n\n    pages = []\n    start, end = 0, 0\n    for page in self.pages:\n        start, end = end, end + page.len\n        if is_reversed:\n            if start &gt; scan_item.start:\n                break\n            if end &lt; scan_item.stop:\n                continue\n        else:\n            if start &gt; scan_item.stop:\n                break\n            if end &lt; scan_item.start:\n                continue\n        ro = intercept(range(start, end), range_item)\n        if len(ro) == 0:\n            continue\n        elif len(ro) == page.len:  # share the whole immutable page\n            pages.append(page)\n        else:  # fetch the slice and filter it.\n            search_slice = slice(ro.start - start, ro.stop - start, ro.step)\n            np_arr = load_numpy(page.path)\n            match = np_arr[search_slice]\n            pages.append(match)\n\n    if is_reversed:\n        pages.reverse()\n        for ix, page in enumerate(pages):\n            if isinstance(page, SimplePage):\n                data = page.get()\n                pages[ix] = np.flip(data)\n            else:\n                pages[ix] = np.flip(page)\n\n    return pages\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.iter_by_page","title":"<code>tablite.base.Column.iter_by_page()</code>","text":"<p>iterates over the column, page by page. This method minimizes the number of reads.</p> RETURNS DESCRIPTION <p>generator of tuple: start: int end: int data: np.ndarray</p> Source code in <code>tablite/base.py</code> <pre><code>def iter_by_page(self):\n    \"\"\"iterates over the column, page by page.\n    This method minimizes the number of reads.\n\n    Returns:\n        generator of tuple:\n            start: int\n            end: int\n            data: np.ndarray\n    \"\"\"\n    start, end = 0, 0\n    for page in self.pages:\n        start, end = end, end + page.len\n        yield start, end, page\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__getitem__","title":"<code>tablite.base.Column.__getitem__(item)</code>","text":"<p>gets numpy array.</p> PARAMETER  DESCRIPTION <code>item</code> <p>slice of column</p> <p> TYPE: <code>int OR slice</code> </p> RETURNS DESCRIPTION <p>np.ndarray: results as numpy array.</p> <p>Remember:</p> <pre><code>&gt;&gt;&gt; R = np.array([0,1,2,3,4,5])\n&gt;&gt;&gt; R[3]\n3\n&gt;&gt;&gt; R[3:4]\narray([3])\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def __getitem__(self, item):  # USER FUNCTION.\n    \"\"\"gets numpy array.\n\n    Args:\n        item (int OR slice): slice of column\n\n    Returns:\n        np.ndarray: results as numpy array.\n\n    Remember:\n    ```\n    &gt;&gt;&gt; R = np.array([0,1,2,3,4,5])\n    &gt;&gt;&gt; R[3]\n    3\n    &gt;&gt;&gt; R[3:4]\n    array([3])\n    ```\n    \"\"\"\n    result = []\n    for element in self.getpages(item):\n        if isinstance(element, SimplePage):\n            result.append(element.get())\n        else:\n            result.append(element)\n\n    if result:\n        arr = np_type_unify(result)\n    else:\n        arr = np.array([])\n\n    if isinstance(item, int):\n        if len(arr) == 0:\n            raise IndexError(\n                f\"index {item} is out of bounds for axis 0 with size {len(self)}\"\n            )\n        return numpy_to_python(arr[0])\n    else:\n        return arr\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__setitem__","title":"<code>tablite.base.Column.__setitem__(key, value)</code>","text":"<p>sets values.</p> PARAMETER  DESCRIPTION <code>key</code> <p>selector</p> <p> TYPE: <code>(int, slice)</code> </p> <code>value</code> <p>values to insert</p> <p> TYPE: <code>any</code> </p> RAISES DESCRIPTION <code>KeyError</code> <p>Following normal slicing rules</p> Source code in <code>tablite/base.py</code> <pre><code>def __setitem__(self, key, value):  # USER FUNCTION.\n    \"\"\"sets values.\n\n    Args:\n        key (int,slice): selector\n        value (any): values to insert\n\n    Raises:\n        KeyError: Following normal slicing rules\n    \"\"\"\n    if isinstance(key, int):\n        self._setitem_integer_key(key, value)\n\n    elif isinstance(key, slice):\n        if not isinstance(value, np.ndarray):\n            value = list_to_np_array(value)\n        type_check(value, np.ndarray)\n\n        if key.start is None and key.stop is None and key.step in (None, 1):\n            self._setitem_replace_all(key, value)\n        elif key.start is not None and key.stop is None and key.step in (None, 1):\n            self._setitem_extend(key, value)\n        elif key.stop is not None and key.start is None and key.step in (None, 1):\n            self._setitem_prextend(key, value)\n        elif (\n            key.step in (None, 1) and key.start is not None and key.stop is not None\n        ):\n            self._setitem_insert(key, value)\n        elif key.step not in (None, 1):\n            self._setitem_update(key, value)\n        else:\n            raise KeyError(f\"bad key: {key}\")\n    else:\n        raise KeyError(f\"bad key: {key}\")\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__delitem__","title":"<code>tablite.base.Column.__delitem__(key)</code>","text":"<p>deletes items selected by key</p> PARAMETER  DESCRIPTION <code>key</code> <p>selector</p> <p> TYPE: <code>(int, slice)</code> </p> RAISES DESCRIPTION <code>KeyError</code> <p>following normal slicing rules.</p> Source code in <code>tablite/base.py</code> <pre><code>def __delitem__(self, key):  # USER FUNCTION\n    \"\"\"deletes items selected by key\n\n    Args:\n        key (int,slice): selector\n\n    Raises:\n        KeyError: following normal slicing rules.\n    \"\"\"\n    if isinstance(key, int):\n        self._del_by_int(key)\n    elif isinstance(key, slice):\n        self._del_by_slice(key)\n    else:\n        raise KeyError(f\"bad key: {key}\")\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.get_by_indices","title":"<code>tablite.base.Column.get_by_indices(indices: Union[List[int], np.ndarray]) -&gt; np.ndarray</code>","text":"<p>retrieves values from column given a set of indices.</p> PARAMETER  DESCRIPTION <code>indices</code> <p>targets</p> <p> TYPE: <code>array</code> </p> <p>This method uses np.take, is faster than iterating over rows. Examples:</p> <pre><code>&gt;&gt;&gt; indices = np.array(list(range(3,700_700, 426)))\n&gt;&gt;&gt; arr = np.array(list(range(2_000_000)))\nPythonic:\n&gt;&gt;&gt; [v for i,v in enumerate(arr) if i in indices]\nNumpyionic:\n&gt;&gt;&gt; np.take(arr, indices)\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def get_by_indices(self, indices: Union[List[int], np.ndarray]) -&gt; np.ndarray:\n    \"\"\"retrieves values from column given a set of indices.\n\n    Args:\n        indices (np.array): targets\n\n    This method uses np.take, is faster than iterating over rows.\n    Examples:\n    ```\n    &gt;&gt;&gt; indices = np.array(list(range(3,700_700, 426)))\n    &gt;&gt;&gt; arr = np.array(list(range(2_000_000)))\n    Pythonic:\n    &gt;&gt;&gt; [v for i,v in enumerate(arr) if i in indices]\n    Numpyionic:\n    &gt;&gt;&gt; np.take(arr, indices)\n    ```\n    \"\"\"\n    type_check(indices, np.ndarray)\n\n    dtypes = set()\n    values = np.empty(\n        indices.shape, dtype=object\n    )  # placeholder for the indexed values.\n\n    for start, end, page in self.iter_by_page():\n        range_match = np.asarray(((indices &gt;= start) &amp; (indices &lt; end)) | (indices == -1)).nonzero()[0]\n        if len(range_match):\n            # only fetch the data if there's a range match!\n            data = page.get() \n            sub_index = np.take(indices, range_match)\n            # sub_index2 otherwise will raise index error where len(data) &gt; (-1 - start)\n            # so the clause below is required:\n            if len(data) &gt; (-1 - start):\n                sub_index = np.where(sub_index == -1, -1, sub_index - start)\n            arr = np.take(data, sub_index)\n            dtypes.add(arr.dtype)\n            np.put(values, range_match, arr)\n\n    if len(dtypes) == 1:  # simplify the datatype\n        dtype = next(iter(dtypes))\n        values = np.array(values, dtype=dtype)\n    return values\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__iter__","title":"<code>tablite.base.Column.__iter__()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __iter__(self):  # USER FUNCTION.\n    for page in self.pages:\n        data = page.get()\n        for value in data:\n            yield value\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__eq__","title":"<code>tablite.base.Column.__eq__(other)</code>","text":"<p>compares two columns. Like <code>list1 == list2</code></p> Source code in <code>tablite/base.py</code> <pre><code>def __eq__(self, other):  # USER FUNCTION.\n    \"\"\"\n    compares two columns. Like `list1 == list2`\n    \"\"\"\n    if len(self) != len(other):  # quick cheap check.\n        return False\n\n    if isinstance(other, (list, tuple)):\n        return all(a == b for a, b in zip(self[:], other))\n\n    elif isinstance(other, Column):\n        if self.pages == other.pages:  # special case.\n            return True\n\n        # are the pages of same size?\n        if len(self.pages) == len(other.pages):\n            if [p.len for p in self.pages] == [p.len for p in other.pages]:\n                for a, b in zip(self.pages, other.pages):\n                    if not (a.get() == b.get()).all():\n                        return False\n                return True\n        # to bad. Element comparison it is then:\n        for a, b in zip(iter(self), iter(other)):\n            if a != b:\n                return False\n        return True\n\n    elif isinstance(other, np.ndarray):\n        start, end = 0, 0\n        for p in self.pages:\n            start, end = end, end + p.len\n            if not (p.get() == other[start:end]).all():\n                return False\n        return True\n    else:\n        raise TypeError(f\"Cannot compare {self.__class__} with {type(other)}\")\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__ne__","title":"<code>tablite.base.Column.__ne__(other)</code>","text":"<p>compares two columns. Like <code>list1 != list2</code></p> Source code in <code>tablite/base.py</code> <pre><code>def __ne__(self, other):  # USER FUNCTION\n    \"\"\"\n    compares two columns. Like `list1 != list2`\n    \"\"\"\n    if len(self) != len(other):  # quick cheap check.\n        return True\n\n    if isinstance(other, (list, tuple)):\n        return any(a != b for a, b in zip(self[:], other))\n\n    elif isinstance(other, Column):\n        if self.pages == other.pages:  # special case.\n            return False\n\n        # are the pages of same size?\n        if len(self.pages) == len(other.pages):\n            if [p.len for p in self.pages] == [p.len for p in other.pages]:\n                for a, b in zip(self.pages, other.pages):\n                    if not (a.get() == b.get()).all():\n                        return True\n                return False\n        # to bad. Element comparison it is then:\n        for a, b in zip(iter(self), iter(other)):\n            if a != b:\n                return True\n        return False\n\n    elif isinstance(other, np.ndarray):\n        start, end = 0, 0\n        for p in self.pages:\n            start, end = end, end + p.len\n            if (p.get() != other[start:end]).any():\n                return True\n        return False\n    else:\n        raise TypeError(f\"Cannot compare {self.__class__} with {type(other)}\")\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.copy","title":"<code>tablite.base.Column.copy()</code>","text":"<p>returns deep=copy of Column</p> RETURNS DESCRIPTION <p>Column</p> Source code in <code>tablite/base.py</code> <pre><code>def copy(self):\n    \"\"\"returns deep=copy of Column\n\n    Returns:\n        Column\n    \"\"\"\n    cp = Column(path=self.path)\n    cp.pages = self.pages[:]\n    return cp\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__copy__","title":"<code>tablite.base.Column.__copy__()</code>","text":"<p>see copy</p> Source code in <code>tablite/base.py</code> <pre><code>def __copy__(self):\n    \"\"\"see copy\"\"\"\n    return self.copy()\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__imul__","title":"<code>tablite.base.Column.__imul__(other)</code>","text":"<p>Repeats instance of column N times. Like list() * N</p> <p>Example:</p> <pre><code>&gt;&gt;&gt; one = Column(data=[1,2])\n&gt;&gt;&gt; one *= 5\n&gt;&gt;&gt; one\n[1,2, 1,2, 1,2, 1,2, 1,2]\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def __imul__(self, other):\n    \"\"\"\n    Repeats instance of column N times. Like list() * N\n\n    Example:\n    ```\n    &gt;&gt;&gt; one = Column(data=[1,2])\n    &gt;&gt;&gt; one *= 5\n    &gt;&gt;&gt; one\n    [1,2, 1,2, 1,2, 1,2, 1,2]\n    ```\n    \"\"\"\n    if not (isinstance(other, int) and other &gt; 0):\n        raise TypeError(\n            f\"a column can be repeated an integer number of times, not {type(other)} number of times\"\n        )\n    self.pages = self.pages[:] * other\n    return self\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__mul__","title":"<code>tablite.base.Column.__mul__(other)</code>","text":"<p>Repeats instance of column N times. Like list() * N</p> <p>Example:</p> <pre><code>&gt;&gt;&gt; one = Column(data=[1,2])\n&gt;&gt;&gt; two = one * 5\n&gt;&gt;&gt; two\n[1,2, 1,2, 1,2, 1,2, 1,2]\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def __mul__(self, other):\n    \"\"\"\n    Repeats instance of column N times. Like list() * N\n\n    Example:\n    ```\n    &gt;&gt;&gt; one = Column(data=[1,2])\n    &gt;&gt;&gt; two = one * 5\n    &gt;&gt;&gt; two\n    [1,2, 1,2, 1,2, 1,2, 1,2]\n    ```\n    \"\"\"\n    if not isinstance(other, int):\n        raise TypeError(\n            f\"a column can be repeated an integer number of times, not {type(other)} number of times\"\n        )\n    cp = self.copy()\n    cp *= other\n    return cp\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__iadd__","title":"<code>tablite.base.Column.__iadd__(other)</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __iadd__(self, other):\n    if isinstance(other, (list, tuple)):\n        other = list_to_np_array(other)\n        self.extend(other)\n    elif isinstance(other, Column):\n        self.pages.extend(other.pages[:])\n    else:\n        raise TypeError(f\"{type(other)} not supported.\")\n    return self\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__contains__","title":"<code>tablite.base.Column.__contains__(item)</code>","text":"<p>determines if item is in the Column. Similar to <code>'x' in ['a','b','c']</code> returns boolean</p> PARAMETER  DESCRIPTION <code>item</code> <p>value to search for</p> <p> TYPE: <code>any</code> </p> RETURNS DESCRIPTION <code>bool</code> <p>True if item exists in column.</p> Source code in <code>tablite/base.py</code> <pre><code>def __contains__(self, item):\n    \"\"\"determines if item is in the Column.\n    Similar to `'x' in ['a','b','c']`\n    returns boolean\n\n    Args:\n        item (any): value to search for\n\n    Returns:\n        bool: True if item exists in column.\n    \"\"\"\n    for page in set(self.pages):\n        if item in page.get():  # x in np.ndarray([...]) uses np.any(arr, value)\n            return True\n    return False\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.remove_all","title":"<code>tablite.base.Column.remove_all(*values)</code>","text":"<p>removes all values of <code>values</code></p> Source code in <code>tablite/base.py</code> <pre><code>def remove_all(self, *values):\n    \"\"\"\n    removes all values of `values`\n    \"\"\"\n    type_check(values, tuple)\n    if isinstance(values[0], tuple):\n        values = values[0]\n    to_remove = list_to_np_array(values)\n    for index, page in enumerate(self.pages):\n        data = page.get()\n        bitmask = np.isin(data, to_remove)  # identify elements to remove.\n        if bitmask.any():\n            bitmask = np.invert(bitmask)  # turn bitmask around to keep.\n            new_data = np.compress(bitmask, data)\n            new_page = Page(self.path, new_data)\n            self.pages[index] = new_page\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.replace","title":"<code>tablite.base.Column.replace(mapping)</code>","text":"<p>replaces values using a mapping.</p> PARAMETER  DESCRIPTION <code>mapping</code> <p>{value to replace: new value, ...}</p> <p> TYPE: <code>dict</code> </p> <p>Example:</p> <pre><code>&gt;&gt;&gt; t = Table(columns={'A': [1,2,3,4]})\n&gt;&gt;&gt; t['A'].replace({2:20,4:40})\n&gt;&gt;&gt; t[:]\nnp.ndarray([1,20,3,40])\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def replace(self, mapping):\n    \"\"\"\n    replaces values using a mapping.\n\n    Args:\n        mapping (dict): {value to replace: new value, ...}\n\n    Example:\n    ```\n    &gt;&gt;&gt; t = Table(columns={'A': [1,2,3,4]})\n    &gt;&gt;&gt; t['A'].replace({2:20,4:40})\n    &gt;&gt;&gt; t[:]\n    np.ndarray([1,20,3,40])\n    ```\n    \"\"\"\n    type_check(mapping, dict)\n    to_replace = np.array(list(mapping.keys()))\n    for index, page in enumerate(self.pages):\n        data = page.get()\n        bitmask = np.isin(data, to_replace)  # identify elements to replace.\n        if bitmask.any():\n            warray = np.compress(bitmask, data)\n            py_dtype = page.dtype\n            for ix, v in enumerate(warray):\n                old_py_val = numpy_to_python(v)\n                new_py_val = mapping[old_py_val]\n                old_dt = type(old_py_val)\n                new_dt = type(new_py_val)\n\n                warray[ix] = new_py_val\n\n                py_dtype[new_dt] = py_dtype.get(new_dt, 0) + 1\n                py_dtype[old_dt] = py_dtype.get(old_dt, 0) - 1\n\n                if py_dtype[old_dt] &lt;= 0:\n                    del py_dtype[old_dt]\n\n            data[bitmask] = warray\n            self.pages[index] = Page(path=self.path, array=data)\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.types","title":"<code>tablite.base.Column.types()</code>","text":"<p>returns dict with python datatypes</p> RETURNS DESCRIPTION <code>dict</code> <p>frequency of occurrence of python datatypes</p> Source code in <code>tablite/base.py</code> <pre><code>def types(self):\n    \"\"\"\n    returns dict with python datatypes\n\n    Returns:\n        dict: frequency of occurrence of python datatypes\n    \"\"\"\n    d = Counter()\n    for page in self.pages:\n        assert isinstance(page.dtype, dict)\n        d += page.dtype\n    return dict(d)\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.index","title":"<code>tablite.base.Column.index()</code>","text":"<p>returns dict with { unique entry : list of indices }</p> <p>example:</p> <pre><code>&gt;&gt;&gt; c = Column(data=['a','b','a','c','b'])\n&gt;&gt;&gt; c.index()\n{'a':[0,2], 'b': [1,4], 'c': [3]}\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def index(self):\n    \"\"\"\n    returns dict with { unique entry : list of indices }\n\n    example:\n    ```\n    &gt;&gt;&gt; c = Column(data=['a','b','a','c','b'])\n    &gt;&gt;&gt; c.index()\n    {'a':[0,2], 'b': [1,4], 'c': [3]}\n    ```\n    \"\"\"\n    d = defaultdict(list)\n    for ix, v in enumerate(self.__iter__()):\n        d[v].append(ix)\n    return dict(d)\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.unique","title":"<code>tablite.base.Column.unique()</code>","text":"<p>returns unique list of values.</p> <p>example:</p> <pre><code>&gt;&gt;&gt; c = Column(data=['a','b','a','c','b'])\n&gt;&gt;&gt; c.unqiue()\n['a','b','c']\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def unique(self):\n    \"\"\"\n    returns unique list of values.\n\n    example:\n    ```\n    &gt;&gt;&gt; c = Column(data=['a','b','a','c','b'])\n    &gt;&gt;&gt; c.unqiue()\n    ['a','b','c']\n    ```\n    \"\"\"\n    arrays = []\n    for page in set(self.pages):\n        try:  # when it works, numpy is fast...\n            arrays.append(np.unique(page.get()))\n        except TypeError:  # ...but np.unique cannot handle Nones.\n            arrays.append(multitype_set(page.get()))\n    union = np_type_unify(arrays)\n    try:\n        return np.unique(union)\n    except MemoryError:\n        return np.array(set(union))\n    except TypeError:\n        return multitype_set(union)\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.histogram","title":"<code>tablite.base.Column.histogram()</code>","text":"<p>returns 2 arrays: unique elements and count of each element</p> <p>example:</p> <pre><code>&gt;&gt;&gt; c = Column(data=['a','b','a','c','b'])\n&gt;&gt;&gt; c.histogram()\n{'a':2,'b':2,'c':1}\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def histogram(self):\n    \"\"\"\n    returns 2 arrays: unique elements and count of each element\n\n    example:\n    ```\n    &gt;&gt;&gt; c = Column(data=['a','b','a','c','b'])\n    &gt;&gt;&gt; c.histogram()\n    {'a':2,'b':2,'c':1}\n    ```\n    \"\"\"\n    d = defaultdict(int)\n    for page in self.pages:\n        try:\n            uarray, carray = np.unique(page.get(), return_counts=True)\n        except TypeError:\n            uarray = page.get()\n            carray = repeat(1, len(uarray))\n\n        for i, c in zip(uarray, carray):\n            v = numpy_to_python(i)\n            d[(type(v), v)] += numpy_to_python(c)\n    u = [v for _, v in d.keys()]\n    c = list(d.values())\n    return u, c  # unique, counts\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.statistics","title":"<code>tablite.base.Column.statistics()</code>","text":"<p>provides summary statistics.</p> RETURNS DESCRIPTION <code>dict</code> <p>returns dict with:</p> <ul> <li>min (int/float, length of str, date)</li> </ul> <ul> <li>max (int/float, length of str, date)</li> </ul> <ul> <li>mean (int/float, length of str, date)</li> </ul> <ul> <li>median (int/float, length of str, date)</li> </ul> <ul> <li>stdev (int/float, length of str, date)</li> </ul> <ul> <li>mode (int/float, length of str, date)</li> </ul> <ul> <li>distinct (int/float, length of str, date)</li> </ul> <ul> <li>iqr (int/float, length of str, date)</li> </ul> <ul> <li>sum (int/float, length of str, date)</li> </ul> <ul> <li>histogram (see .histogram)</li> </ul> Source code in <code>tablite/base.py</code> <pre><code>def statistics(self):\n    \"\"\"provides summary statistics.\n\n    Returns:\n        dict: returns dict with:\n        - min (int/float, length of str, date)\n        - max (int/float, length of str, date)\n        - mean (int/float, length of str, date)\n        - median (int/float, length of str, date)\n        - stdev (int/float, length of str, date)\n        - mode (int/float, length of str, date)\n        - distinct (int/float, length of str, date)\n        - iqr (int/float, length of str, date)\n        - sum (int/float, length of str, date)\n        - histogram (see .histogram)\n    \"\"\"\n    values, counts = self.histogram()\n    return summary_statistics(values, counts)\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.count","title":"<code>tablite.base.Column.count(item)</code>","text":"<p>counts appearances of item in column.</p> <p>Note that in python, <code>True == 1</code> and <code>False == 0</code>, whereby the following difference occurs:</p> <p>in python:</p> <pre><code>&gt;&gt;&gt; L = [1, True]\n&gt;&gt;&gt; L.count(True)\n2\n</code></pre> <p>in tablite:</p> <pre><code>&gt;&gt;&gt; t = Table({'L': [1,True]})\n&gt;&gt;&gt; t['L'].count(True)\n1\n</code></pre> PARAMETER  DESCRIPTION <code>item</code> <p>target item</p> <p> TYPE: <code>Any</code> </p> RETURNS DESCRIPTION <code>int</code> <p>number of occurrences of item.</p> Source code in <code>tablite/base.py</code> <pre><code>def count(self, item):\n    \"\"\"counts appearances of item in column.\n\n    Note that in python, `True == 1` and `False == 0`,\n    whereby the following difference occurs:\n\n    in python:\n    ```\n    &gt;&gt;&gt; L = [1, True]\n    &gt;&gt;&gt; L.count(True)\n    2\n    ```\n    in tablite:\n    ```\n    &gt;&gt;&gt; t = Table({'L': [1,True]})\n    &gt;&gt;&gt; t['L'].count(True)\n    1\n    ```\n\n    Args:\n        item (Any): target item\n\n    Returns:\n        int: number of occurrences of item.\n    \"\"\"\n    result = 0\n    for page in self.pages:\n        data = page.get()\n        if data.dtype != \"O\":\n            result += np.nonzero(page.get() == item)[0].shape[0]\n            # what happens here ---^ below:\n            # arr = page.get()\n            # &gt;&gt;&gt; arr\n            # array([1,2,3,4,3], int64)\n            # &gt;&gt;&gt; (arr == 3)\n            # array([False, False,  True, False,  True])\n            # &gt;&gt;&gt; np.nonzero(arr==3)\n            # (array([2,4], dtype=int64), )  &lt;-- tuple!\n            # &gt;&gt;&gt; np.nonzero(page.get() == item)[0]\n            # array([2,4])\n            # &gt;&gt;&gt; np.nonzero(page.get() == item)[0].shape\n            # (2, )\n            # &gt;&gt;&gt; np.nonzero(page.get() == item)[0].shape[0]\n            # 2\n        else:\n            result += sum(1 for i in data if type(i) == type(item) and i == item)\n    return result\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable","title":"<code>tablite.base.BaseTable(columns: [dict, None] = None, headers: [list, None] = None, rows: [list, None] = None, _path: [Path, None] = None)</code>","text":"<p>             Bases: <code>object</code></p> <p>creates Table</p> PARAMETER  DESCRIPTION <code>EITHER</code> <p>columns (dict, optional): dict with column names as keys, values as lists. Example: t = Table(columns={\"a\": [1, 2], \"b\": [3, 4]})</p> <p> </p> <code>_path</code> <p>path to main process working directory.</p> <p> TYPE: <code>Path</code> DEFAULT: <code>None</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def __init__(\n    self,\n    columns: [dict, None] = None,\n    headers: [list, None] = None,\n    rows: [list, None] = None,\n    _path: [Path, None] = None,\n) -&gt; None:\n    \"\"\"creates Table\n\n    Args:\n        EITHER:\n            columns (dict, optional): dict with column names as keys, values as lists.\n            Example: t = Table(columns={\"a\": [1, 2], \"b\": [3, 4]})\n        OR\n            headers (list of strings, optional): list of column names.\n            rows (list of tuples or lists, optional): values for columns\n            Example: t = Table(headers=[\"a\", \"b\"], rows=[[1,3], [2,4]])\n\n        _path (pathlib.Path, optional): path to main process working directory.\n    \"\"\"\n    if _path is None:\n        if self._pid_dir is None:\n            self._pid_dir = Path(Config.workdir) / Config.pid\n            if not self._pid_dir.exists():\n                self._pid_dir.mkdir()\n                (self._pid_dir / \"pages\").mkdir()\n            register(self._pid_dir)\n\n        _path = Path(self._pid_dir)\n        # if path exists under the given PID it will be overwritten.\n        # this can only happen if the process previously was SIGKILLed.\n    type_check(_path, Path)\n    self.path = _path  # filename used during multiprocessing.\n    self.columns = {}  # maps colunn names to instances of Column.\n\n    # user friendly features.\n    if columns and any((headers, rows)):\n        raise ValueError(\"Either columns as dict OR headers and rows. Not both.\")\n\n    if headers and rows:\n        rotated = list(zip(*rows))\n        columns = {k: v for k, v in zip(headers, rotated)}\n\n    if columns:\n        type_check(columns, dict)\n        for k, v in columns.items():\n            self.__setitem__(k, v)\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable-attributes","title":"Attributes","text":""},{"location":"reference/base/#tablite.base.BaseTable.path","title":"<code>tablite.base.BaseTable.path = _path</code>  <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.BaseTable.columns","title":"<code>tablite.base.BaseTable.columns = {}</code>  <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.BaseTable.rows","title":"<code>tablite.base.BaseTable.rows</code>  <code>property</code>","text":"<p>enables row based iteration in python types.</p> <p>Example:</p> <pre><code>for row in Table.rows:\n    print(row)\n</code></pre> <p>Yields:     tuple: values is same order as columns.</p>"},{"location":"reference/base/#tablite.base.BaseTable-functions","title":"Functions","text":""},{"location":"reference/base/#tablite.base.BaseTable.__str__","title":"<code>tablite.base.BaseTable.__str__()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __str__(self):  # USER FUNCTION.\n    return f\"{self.__class__.__name__}({len(self.columns):,} columns, {len(self):,} rows)\"\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.__repr__","title":"<code>tablite.base.BaseTable.__repr__()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __repr__(self):\n    return self.__str__()\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.nbytes","title":"<code>tablite.base.BaseTable.nbytes()</code>","text":"<p>finds the total bytes of the table on disk</p> RETURNS DESCRIPTION <code>tuple</code> <p>int: real bytes used on disk int: total bytes used if flattened</p> Source code in <code>tablite/base.py</code> <pre><code>def nbytes(self):  # USER FUNCTION.\n    \"\"\"finds the total bytes of the table on disk\n\n    Returns:\n        tuple:\n            int: real bytes used on disk\n            int: total bytes used if flattened\n    \"\"\"\n    real = {}\n    total = 0\n    for column in self.columns.values():\n        for page in set(column.pages):\n            real[page] = page.path.stat().st_size\n        for page in column.pages:\n            total += real[page]\n    return sum(real.values()), total\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.items","title":"<code>tablite.base.BaseTable.items()</code>","text":"<p>returns table as dict</p> RETURNS DESCRIPTION <code>dict</code> <p>Table as dict <code>{column_name: [values], ...}</code></p> Source code in <code>tablite/base.py</code> <pre><code>def items(self):  # USER FUNCTION.\n    \"\"\"returns table as dict\n\n    Returns:\n        dict: Table as dict `{column_name: [values], ...}`\n    \"\"\"\n    return {\n        name: column[:].tolist() for name, column in self.columns.items()\n    }.items()\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.__delitem__","title":"<code>tablite.base.BaseTable.__delitem__(key)</code>","text":"<p>Examples:</p> <pre><code>&gt;&gt;&gt; del table['a']  # removes column 'a'\n&gt;&gt;&gt; del table[-3:]  # removes last 3 rows from all columns.\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def __delitem__(self, key):  # USER FUNCTION.\n    \"\"\"\n    Examples:\n    ```\n    &gt;&gt;&gt; del table['a']  # removes column 'a'\n    &gt;&gt;&gt; del table[-3:]  # removes last 3 rows from all columns.\n    ```\n    \"\"\"\n    if isinstance(key, (int, slice)):\n        for column in self.columns.values():\n            del column[key]\n    elif key in self.columns:\n        del self.columns[key]\n    else:\n        raise KeyError(f\"Key not found: {key}\")\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.__setitem__","title":"<code>tablite.base.BaseTable.__setitem__(key, value)</code>","text":"<p>table behaves like a dict. Args:     key (str or hashable): column name     value (iterable): list, tuple or nd.array with values.</p> <p>As Table now accepts the keyword <code>columns</code> as a dict:</p> <pre><code>&gt;&gt;&gt; t = Table(columns={'b':[4,5,6], 'c':[7,8,9]})\n</code></pre> <p>and the header/data combinations:</p> <pre><code>&gt;&gt;&gt; t = Table(header=['b','c'], data=[[4,5,6],[7,8,9]])\n</code></pre> <p>This has the side-benefit that tuples now can be used as headers.</p> Source code in <code>tablite/base.py</code> <pre><code>def __setitem__(self, key, value):  # USER FUNCTION\n    \"\"\"table behaves like a dict.\n    Args:\n        key (str or hashable): column name\n        value (iterable): list, tuple or nd.array with values.\n\n    As Table now accepts the keyword `columns` as a dict:\n    ```\n    &gt;&gt;&gt; t = Table(columns={'b':[4,5,6], 'c':[7,8,9]})\n    ```\n    and the header/data combinations:\n    ```\n    &gt;&gt;&gt; t = Table(header=['b','c'], data=[[4,5,6],[7,8,9]])\n    ```\n    This has the side-benefit that tuples now can be used as headers.\n    \"\"\"\n    if value is None:\n        self.columns[key] = Column(self.path, value=None)\n    elif isinstance(value, (list, tuple)):\n        value = list_to_np_array(value)\n        self.columns[key] = Column(self.path, value)\n    elif isinstance(value, (np.ndarray)):\n        self.columns[key] = Column(self.path, value)\n    elif isinstance(value, Column):\n        self.columns[key] = value\n    else:\n        raise TypeError(f\"{type(value)} not supported.\")\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.__getitem__","title":"<code>tablite.base.BaseTable.__getitem__(keys)</code>","text":"<p>Enables selection of columns and rows</p> PARAMETER  DESCRIPTION <code>keys</code> <p> TYPE: <code>column name, integer or slice</code> </p> <code>Examples</code> <p> </p> <code>&gt;&gt;&gt;</code> <p>10]                        selects first 10 rows from all columns</p> <p> TYPE: <code>table[</code> </p> <code>&gt;&gt;&gt;</code> <p>20:3] selects column 'b' and 'c' and 'a' twice for a slice.</p> <p> TYPE: <code>table['b', 'a', 'a', 'c', 2</code> </p> <p>Raises:     KeyError: if key is not found.     TypeError: if key is not a string, integer or slice.</p> RETURNS DESCRIPTION <code>Table</code> <p>returns columns in same order as selection.</p> Source code in <code>tablite/base.py</code> <pre><code>def __getitem__(self, keys):  # USER FUNCTION\n    \"\"\"\n    Enables selection of columns and rows\n\n    Args:\n        keys (column name, integer or slice):\n        Examples:\n        ```\n        &gt;&gt;&gt; table['a']                        selects column 'a'\n        &gt;&gt;&gt; table[3]                          selects row 3 as a tuple.\n        &gt;&gt;&gt; table[:10]                        selects first 10 rows from all columns\n        &gt;&gt;&gt; table['a','b', slice(3,20,2)]     selects a slice from columns 'a' and 'b'\n        &gt;&gt;&gt; table['b', 'a', 'a', 'c', 2:20:3] selects column 'b' and 'c' and 'a' twice for a slice.\n        &gt;&gt;&gt; table[('b', 'a', 'a', 'c')]       selects columns 'b', 'a', 'a', and 'c' using a tuple.\n        ```\n    Raises:\n        KeyError: if key is not found.\n        TypeError: if key is not a string, integer or slice.\n\n    Returns:\n        Table: returns columns in same order as selection.\n    \"\"\"\n\n    if not isinstance(keys, tuple):\n        if isinstance(keys, list):\n            keys = tuple(keys)\n        else:\n            keys = (keys,)\n    if isinstance(keys[0], tuple):\n        keys = tuple(list(chain(*keys)))\n\n    integers = [i for i in keys if isinstance(i, int)]\n    if len(integers) == len(keys) == 1:  # return a single tuple.\n        keys = [slice(keys[0])]\n\n    column_names = [i for i in keys if isinstance(i, str)]\n    column_names = list(self.columns) if not column_names else column_names\n    not_found = [name for name in column_names if name not in self.columns]\n    if not_found:\n        raise KeyError(f\"keys not found: {', '.join(not_found)}\")\n\n    slices = [i for i in keys if isinstance(i, slice)]\n    slc = slice(0, len(self)) if not slices else slices[0]\n\n    if (\n        len(slices) == 0 and len(column_names) == 1\n    ):  # e.g. tbl['a'] or tbl['a'][:10]\n        col = self.columns[column_names[0]]\n        if slices:\n            return col[slc]  # return slice from column as list of values\n        else:\n            return col  # return whole column\n\n    elif len(integers) == 1:  # return a single tuple.\n        row_no = integers[0]\n        slc = slice(row_no, row_no + 1)\n        return tuple(self.columns[name][slc].tolist()[0] for name in column_names)\n\n    elif not slices:  # e.g. new table with N whole columns.\n        return self.__class__(\n            columns={name: self.columns[name] for name in column_names}\n        )\n\n    else:  # e.g. new table from selection of columns and slices.\n        t = self.__class__()\n        for name in column_names:\n            column = self.columns[name]\n\n            new_column = Column(t.path)  # create new Column.\n            for item in column.getpages(slc):\n                if isinstance(item, np.ndarray):\n                    new_column.extend(item)  # extend subslice (expensive)\n                elif isinstance(item, SimplePage):\n                    new_column.pages.append(item)  # extend page (cheap)\n                else:\n                    raise TypeError(f\"Bad item: {item}\")\n\n            # below:\n            # set the new column directly on t.columns.\n            # Do not use t[name] as that triggers __setitem__ again.\n            t.columns[name] = new_column\n\n        return t\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.__len__","title":"<code>tablite.base.BaseTable.__len__()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __len__(self):  # USER FUNCTION.\n    if not self.columns:\n        return 0\n    return max(len(c) for c in self.columns.values())\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.__eq__","title":"<code>tablite.base.BaseTable.__eq__(other) -&gt; bool</code>","text":"<p>Determines if two tables have identical content.</p> PARAMETER  DESCRIPTION <code>other</code> <p>table for comparison</p> <p> TYPE: <code>Table</code> </p> RETURNS DESCRIPTION <code>bool</code> <p>True if tables are identical.</p> <p> TYPE: <code>bool</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def __eq__(self, other) -&gt; bool:  # USER FUNCTION.\n    \"\"\"Determines if two tables have identical content.\n\n    Args:\n        other (Table): table for comparison\n\n    Returns:\n        bool: True if tables are identical.\n    \"\"\"\n    if isinstance(other, dict):\n        return self.items() == other.items()\n    if not isinstance(other, BaseTable):\n        return False\n    if id(self) == id(other):\n        return True\n    if len(self) != len(other):\n        return False\n    if len(self) == len(other) == 0:\n        return True\n    if self.columns.keys() != other.columns.keys():\n        return False\n    for name, col in self.columns.items():\n        if not (col == other.columns[name]):\n            return False\n    return True\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.clear","title":"<code>tablite.base.BaseTable.clear()</code>","text":"<p>clears the table. Like dict().clear()</p> Source code in <code>tablite/base.py</code> <pre><code>def clear(self):  # USER FUNCTION.\n    \"\"\"clears the table. Like dict().clear()\"\"\"\n    self.columns.clear()\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.save","title":"<code>tablite.base.BaseTable.save(path, compression_method=zipfile.ZIP_DEFLATED, compression_level=1)</code>","text":"<p>saves table to compressed tpz file.</p> PARAMETER  DESCRIPTION <code>path</code> <p>file destination.</p> <p> TYPE: <code>Path</code> </p> <code>compression_method</code> <p>See zipfile compression methods. Defaults to ZIP_DEFLATED.</p> <p> DEFAULT: <code>ZIP_DEFLATED</code> </p> <code>compression_level</code> <p>See zipfile compression levels. Defaults to 1.</p> <p> DEFAULT: <code>1</code> </p> <p>The file format is as follows: .tpz is a gzip archive with table metadata captured as table.yml and the necessary set of pages saved as .npy files.</p> <p>The zip contains table.yml which provides an overview of the data:</p> <pre><code>--------------------------------------\n%YAML 1.2                              yaml version\ncolumns:                               start of columns section.\n    name: \u201c\u5217 1\u201d                       name of column 1.\n        pages: [p1b1, p1b2]            list of pages in column 1.\n    name: \u201c\u5217 2\u201d                       name of column 2\n        pages: [p2b1, p2b2]            list of pages in column 2.\n----------------------------------------\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def save(\n    self, path, compression_method=zipfile.ZIP_DEFLATED, compression_level=1\n):  # USER FUNCTION.\n    \"\"\"saves table to compressed tpz file.\n\n    Args:\n        path (Path): file destination.\n        compression_method: See zipfile compression methods. Defaults to ZIP_DEFLATED.\n        compression_level: See zipfile compression levels. Defaults to 1.\n        The default settings produce 80% compression at 10% slowdown.\n\n    The file format is as follows:\n    .tpz is a gzip archive with table metadata captured as table.yml\n    and the necessary set of pages saved as .npy files.\n\n    The zip contains table.yml which provides an overview of the data:\n    ```\n    --------------------------------------\n    %YAML 1.2                              yaml version\n    columns:                               start of columns section.\n        name: \u201c\u5217 1\u201d                       name of column 1.\n            pages: [p1b1, p1b2]            list of pages in column 1.\n        name: \u201c\u5217 2\u201d                       name of column 2\n            pages: [p2b1, p2b2]            list of pages in column 2.\n    ----------------------------------------\n    ```\n    \"\"\"\n    if isinstance(path, str):\n        path = Path(path)\n    type_check(path, Path)\n    if path.is_dir():\n        raise TypeError(f\"filename needed: {path}\")\n    if path.suffix != \".tpz\":\n        path = path.parent / (path.parts[-1] + \".tpz\")\n\n    # create yaml document\n    _page_counter = 0\n    d = {}\n    cols = {}\n    for name, col in self.columns.items():\n        type_check(col, Column)\n        cols[name] = {\"pages\": [p.path.name for p in col.pages]}\n        _page_counter += len(col.pages)\n    d[\"columns\"] = cols\n    yml = yaml.safe_dump(\n        d, sort_keys=False, allow_unicode=True, default_flow_style=None\n    )\n\n    _file_counter = 0\n    with zipfile.ZipFile(\n        path, \"w\", compression=compression_method, compresslevel=compression_level\n    ) as f:\n        log.debug(f\"writing .tpz to {path} with\\n{yml}\")\n        f.writestr(\"table.yml\", yml)\n        for name, col in self.columns.items():\n            for page in set(\n                col.pages\n            ):  # set of pages! remember t *= 1000 repeats t 1000x\n                with open(page.path, \"rb\", buffering=0) as raw_io:\n                    f.writestr(page.path.name, raw_io.read())\n                _file_counter += 1\n                log.debug(f\"adding Page {page.path}\")\n\n        _fields = len(self) * len(self.columns)\n        _avg = _fields // _page_counter\n        log.debug(\n            f\"Wrote {_fields:,} on {_page_counter:,} pages in {_file_counter} files: {_avg} fields/page\"\n        )\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.load","title":"<code>tablite.base.BaseTable.load(path, tqdm=_tqdm)</code>  <code>classmethod</code>","text":"<p>loads a table from .tpz file. See also Table.save for details on the file format.</p> PARAMETER  DESCRIPTION <code>path</code> <p>source file</p> <p> TYPE: <code>Path</code> </p> RETURNS DESCRIPTION <code>Table</code> <p>table in read-only mode.</p> Source code in <code>tablite/base.py</code> <pre><code>@classmethod\ndef load(cls, path, tqdm=_tqdm):  # USER FUNCTION.\n    \"\"\"loads a table from .tpz file.\n    See also Table.save for details on the file format.\n\n    Args:\n        path (Path): source file\n\n    Returns:\n        Table: table in read-only mode.\n    \"\"\"\n    path = Path(path)\n    log.debug(f\"loading {path}\")\n    with zipfile.ZipFile(path, \"r\") as f:\n        yml = f.read(\"table.yml\")\n        metadata = yaml.safe_load(yml)\n        t = cls()\n\n        page_count = sum([len(c[\"pages\"]) for c in metadata[\"columns\"].values()])\n\n        with tqdm(\n            total=page_count,\n            desc=f\"loading '{path.name}' file\",\n            disable=Config.TQDM_DISABLE,\n        ) as pbar:\n            for name, d in metadata[\"columns\"].items():\n                column = Column(t.path)\n                for page in d[\"pages\"]:\n                    bytestream = io.BytesIO(f.read(page))\n                    data = np.load(bytestream, allow_pickle=True, fix_imports=False)\n                    column.extend(data)\n                    pbar.update(1)\n                t.columns[name] = column\n    update_access_time(path)\n    return t\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.copy","title":"<code>tablite.base.BaseTable.copy()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def copy(self):\n    cls = type(self)\n    t = cls()\n    for name, column in self.columns.items():\n        new = Column(t.path)\n        new.pages = column.pages[:]\n        t.columns[name] = new\n    return t\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.__imul__","title":"<code>tablite.base.BaseTable.__imul__(other)</code>","text":"<p>Repeats instance of table N times.</p> <p>Like list: <code>t = t * N</code></p> PARAMETER  DESCRIPTION <code>other</code> <p>multiplier</p> <p> TYPE: <code>int</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def __imul__(self, other):\n    \"\"\"Repeats instance of table N times.\n\n    Like list: `t = t * N`\n\n    Args:\n        other (int): multiplier\n    \"\"\"\n    if not (isinstance(other, int) and other &gt; 0):\n        raise TypeError(\n            f\"a table can be repeated an integer number of times, not {type(other)} number of times\"\n        )\n    for col in self.columns.values():\n        col *= other\n    return self\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.__mul__","title":"<code>tablite.base.BaseTable.__mul__(other)</code>","text":"<p>Repeat table N times. Like list: <code>new = old * N</code></p> PARAMETER  DESCRIPTION <code>other</code> <p>multiplier</p> <p> TYPE: <code>int</code> </p> RETURNS DESCRIPTION <p>Table</p> Source code in <code>tablite/base.py</code> <pre><code>def __mul__(self, other):\n    \"\"\"Repeat table N times.\n    Like list: `new = old * N`\n\n    Args:\n        other (int): multiplier\n\n    Returns:\n        Table\n    \"\"\"\n    new = self.copy()\n    return new.__imul__(other)\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.__iadd__","title":"<code>tablite.base.BaseTable.__iadd__(other)</code>","text":"<p>Concatenates tables with same column names.</p> <p>Like list: <code>table_1 += table_2</code></p> RAISES DESCRIPTION <code>ValueError</code> <p>If column names don't match.</p> RETURNS DESCRIPTION <code>None</code> <p>self is updated.</p> Source code in <code>tablite/base.py</code> <pre><code>def __iadd__(self, other):\n    \"\"\"Concatenates tables with same column names.\n\n    Like list: `table_1 += table_2`\n\n    Args:\n        other (Table)\n\n    Raises:\n        ValueError: If column names don't match.\n\n    Returns:\n        None: self is updated.\n    \"\"\"\n    type_check(other, BaseTable)\n    for name in self.columns.keys():\n        if name not in other.columns:\n            raise ValueError(f\"{name} not in other\")\n    for name in other.columns.keys():\n        if name not in self.columns:\n            raise ValueError(f\"{name} missing from self\")\n\n    for name, column in self.columns.items():\n        other_col = other.columns.get(name, None)\n        column.pages.extend(other_col.pages[:])\n    return self\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.__add__","title":"<code>tablite.base.BaseTable.__add__(other)</code>","text":"<p>Concatenates tables with same column names.</p> <p>Like list: <code>table_3 = table_1 + table_2</code></p> RAISES DESCRIPTION <code>ValueError</code> <p>If column names don't match.</p> RETURNS DESCRIPTION <p>Table</p> Source code in <code>tablite/base.py</code> <pre><code>def __add__(self, other):\n    \"\"\"Concatenates tables with same column names.\n\n    Like list: `table_3 = table_1 + table_2`\n\n    Args:\n        other (Table)\n\n    Raises:\n        ValueError: If column names don't match.\n\n    Returns:\n        Table\n    \"\"\"\n    type_check(other, BaseTable)\n    cp = self.copy()\n    cp += other\n    return cp\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.add_rows","title":"<code>tablite.base.BaseTable.add_rows(*args, **kwargs)</code>","text":"<p>its more efficient to add many rows at once.</p> <p>if both args and kwargs, then args are added first, followed by kwargs.</p> <p>supported cases:</p> <pre><code>&gt;&gt;&gt; t = Table()\n&gt;&gt;&gt; t.add_columns('row','A','B','C')\n&gt;&gt;&gt; t.add_rows(1, 1, 2, 3)                              # (1) individual values as args\n&gt;&gt;&gt; t.add_rows([2, 1, 2, 3])                            # (2) list of values as args\n&gt;&gt;&gt; t.add_rows((3, 1, 2, 3))                            # (3) tuple of values as args\n&gt;&gt;&gt; t.add_rows(*(4, 1, 2, 3))                           # (4) unpacked tuple becomes arg like (1)\n&gt;&gt;&gt; t.add_rows(row=5, A=1, B=2, C=3)                    # (5) kwargs\n&gt;&gt;&gt; t.add_rows(**{'row': 6, 'A': 1, 'B': 2, 'C': 3})    # (6) dict / json interpreted a kwargs\n&gt;&gt;&gt; t.add_rows((7, 1, 2, 3), (8, 4, 5, 6))              # (7) two (or more) tuples as args\n&gt;&gt;&gt; t.add_rows([9, 1, 2, 3], [10, 4, 5, 6])             # (8) two or more lists as rgs\n&gt;&gt;&gt; t.add_rows(\n    {'row': 11, 'A': 1, 'B': 2, 'C': 3},\n    {'row': 12, 'A': 4, 'B': 5, 'C': 6}\n    )                                                   # (9) two (or more) dicts as args - roughly comma sep'd json.\n&gt;&gt;&gt; t.add_rows( *[\n    {'row': 13, 'A': 1, 'B': 2, 'C': 3},\n    {'row': 14, 'A': 1, 'B': 2, 'C': 3}\n    ])                                                  # (10) list of dicts as args\n&gt;&gt;&gt; t.add_rows(row=[15,16], A=[1,1], B=[2,2], C=[3,3])  # (11) kwargs with lists as values\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def add_rows(self, *args, **kwargs):\n    \"\"\"its more efficient to add many rows at once.\n\n    if both args and kwargs, then args are added first, followed by kwargs.\n\n    supported cases:\n    ```\n    &gt;&gt;&gt; t = Table()\n    &gt;&gt;&gt; t.add_columns('row','A','B','C')\n    &gt;&gt;&gt; t.add_rows(1, 1, 2, 3)                              # (1) individual values as args\n    &gt;&gt;&gt; t.add_rows([2, 1, 2, 3])                            # (2) list of values as args\n    &gt;&gt;&gt; t.add_rows((3, 1, 2, 3))                            # (3) tuple of values as args\n    &gt;&gt;&gt; t.add_rows(*(4, 1, 2, 3))                           # (4) unpacked tuple becomes arg like (1)\n    &gt;&gt;&gt; t.add_rows(row=5, A=1, B=2, C=3)                    # (5) kwargs\n    &gt;&gt;&gt; t.add_rows(**{'row': 6, 'A': 1, 'B': 2, 'C': 3})    # (6) dict / json interpreted a kwargs\n    &gt;&gt;&gt; t.add_rows((7, 1, 2, 3), (8, 4, 5, 6))              # (7) two (or more) tuples as args\n    &gt;&gt;&gt; t.add_rows([9, 1, 2, 3], [10, 4, 5, 6])             # (8) two or more lists as rgs\n    &gt;&gt;&gt; t.add_rows(\n        {'row': 11, 'A': 1, 'B': 2, 'C': 3},\n        {'row': 12, 'A': 4, 'B': 5, 'C': 6}\n        )                                                   # (9) two (or more) dicts as args - roughly comma sep'd json.\n    &gt;&gt;&gt; t.add_rows( *[\n        {'row': 13, 'A': 1, 'B': 2, 'C': 3},\n        {'row': 14, 'A': 1, 'B': 2, 'C': 3}\n        ])                                                  # (10) list of dicts as args\n    &gt;&gt;&gt; t.add_rows(row=[15,16], A=[1,1], B=[2,2], C=[3,3])  # (11) kwargs with lists as values\n    ```\n\n    \"\"\"\n    if not BaseTable._add_row_slow_warning:\n        warnings.warn(\n            \"add_rows is slow. Consider using add_columns and then assigning values to the columns directly.\"\n        )\n        BaseTable._add_row_slow_warning = True\n\n    if args:\n        if not all(isinstance(i, (list, tuple, dict)) for i in args):  # 1,4\n            args = [args]\n\n        if all(isinstance(i, (list, tuple, dict)) for i in args):  # 2,3,7,8\n            # 1. turn the data into columns:\n\n            d = {n: [] for n in self.columns}\n            for arg in args:\n                if len(arg) != len(self.columns):\n                    raise ValueError(\n                        f\"len({arg})== {len(arg)}, but there are {len(self.columns)} columns\"\n                    )\n\n                if isinstance(arg, dict):\n                    for k, v in arg.items():  # 7,8\n                        d[k].append(v)\n\n                elif isinstance(arg, (list, tuple)):  # 2,3\n                    for n, v in zip(self.columns, arg):\n                        d[n].append(v)\n\n                else:\n                    raise TypeError(f\"{arg}?\")\n            # 2. extend the columns\n            for n, values in d.items():\n                col = self.columns[n]\n                col.extend(list_to_np_array(values))\n\n    if kwargs:\n        if isinstance(kwargs, dict):\n            if all(isinstance(v, (list, tuple)) for v in kwargs.values()):\n                for k, v in kwargs.items():\n                    col = self.columns[k]\n                    col.extend(list_to_np_array(v))\n            else:\n                for k, v in kwargs.items():\n                    col = self.columns[k]\n                    col.extend(np.array([v]))\n        else:\n            raise ValueError(f\"format not recognised: {kwargs}\")\n\n    return\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.add_columns","title":"<code>tablite.base.BaseTable.add_columns(*names)</code>","text":"<p>Adds column names to table.</p> Source code in <code>tablite/base.py</code> <pre><code>def add_columns(self, *names):\n    \"\"\"Adds column names to table.\"\"\"\n    for name in names:\n        self.columns[name] = Column(self.path)\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.add_column","title":"<code>tablite.base.BaseTable.add_column(name, data=None)</code>","text":"<p>verbose alias for table[name] = data, that checks if name already exists</p> PARAMETER  DESCRIPTION <code>name</code> <p>column name</p> <p> TYPE: <code>str</code> </p> <code>data</code> <p>values. Defaults to None.</p> <p> TYPE: <code>list,tuple)</code> DEFAULT: <code>None</code> </p> RAISES DESCRIPTION <code>TypeError</code> <p>name isn't string</p> <code>ValueError</code> <p>name already exists</p> Source code in <code>tablite/base.py</code> <pre><code>def add_column(self, name, data=None):\n    \"\"\"verbose alias for table[name] = data, that checks if name already exists\n\n    Args:\n        name (str): column name\n        data ((list,tuple), optional): values. Defaults to None.\n\n    Raises:\n        TypeError: name isn't string\n        ValueError: name already exists\n    \"\"\"\n    if not isinstance(name, str):\n        raise TypeError(\"expected name as string\")\n    if name in self.columns:\n        raise ValueError(f\"{name} already in {self.columns}\")\n    self.__setitem__(name, data)\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.stack","title":"<code>tablite.base.BaseTable.stack(other)</code>","text":"<p>returns the joint stack of tables with overlapping column names. Example:</p> <pre><code>| Table A|  +  | Table B| = |  Table AB |\n| A| B| C|     | A| B| D|   | A| B| C| -|\n                            | A| B| -| D|\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def stack(self, other):\n    \"\"\"\n    returns the joint stack of tables with overlapping column names.\n    Example:\n    ```\n    | Table A|  +  | Table B| = |  Table AB |\n    | A| B| C|     | A| B| D|   | A| B| C| -|\n                                | A| B| -| D|\n    ```\n    \"\"\"\n    if not isinstance(other, BaseTable):\n        raise TypeError(f\"stack only works for Table, not {type(other)}\")\n\n    cp = self.copy()\n    for name, col2 in other.columns.items():\n        if name not in cp.columns:\n            cp[name] = [None] * len(self)\n        cp[name].pages.extend(col2.pages[:])\n\n    for name in self.columns:\n        if name not in other.columns:\n            if len(cp) &gt; 0:\n                cp[name].extend(np.array([None] * len(other)))\n    return cp\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.types","title":"<code>tablite.base.BaseTable.types()</code>","text":"<p>returns nested dict of data types in the form: <code>{column name: {python type class: number of instances }, ... }</code></p> <p>example:</p> <pre><code>&gt;&gt;&gt; t.types()\n{\n    'A': {&lt;class 'str'&gt;: 7},\n    'B': {&lt;class 'int'&gt;: 7}\n}\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def types(self):\n    \"\"\"\n    returns nested dict of data types in the form:\n    `{column name: {python type class: number of instances }, ... }`\n\n    example:\n    ```\n    &gt;&gt;&gt; t.types()\n    {\n        'A': {&lt;class 'str'&gt;: 7},\n        'B': {&lt;class 'int'&gt;: 7}\n    }\n    ```\n    \"\"\"\n    d = {}\n    for name, col in self.columns.items():\n        assert isinstance(col, Column)\n        d[name] = col.types()\n    return d\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.display_dict","title":"<code>tablite.base.BaseTable.display_dict(slice_=None, blanks=None, dtype=False)</code>","text":"<p>helper for creating dict for display.</p> PARAMETER  DESCRIPTION <code>slice_</code> <p>python slice. Defaults to None.</p> <p> TYPE: <code>slice</code> DEFAULT: <code>None</code> </p> <code>blanks</code> <p>fill value for <code>None</code>. Defaults to None.</p> <p> TYPE: <code>optional</code> DEFAULT: <code>None</code> </p> <code>dtype</code> <p>Adds datatype to each column. Defaults to False.</p> <p> TYPE: <code>bool</code> DEFAULT: <code>False</code> </p> RAISES DESCRIPTION <code>TypeError</code> <p>slice_ must be None or slice.</p> RETURNS DESCRIPTION <code>dict</code> <p>from Table.</p> Source code in <code>tablite/base.py</code> <pre><code>def display_dict(self, slice_=None, blanks=None, dtype=False):\n    \"\"\"helper for creating dict for display.\n\n    Args:\n        slice_ (slice, optional): python slice. Defaults to None.\n        blanks (optional): fill value for `None`. Defaults to None.\n        dtype (bool, optional): Adds datatype to each column. Defaults to False.\n\n    Raises:\n        TypeError: slice_ must be None or slice.\n\n    Returns:\n        dict: from Table.\n    \"\"\"\n    if not self.columns:\n        print(\"Empty Table\")\n        return\n\n    def datatype(col):  # PRIVATE\n        \"\"\"creates label for column datatype.\"\"\"\n        types = col.types()\n        if len(types) == 0:\n            typ = \"empty\"\n        elif len(types) == 1:\n            dt, _ = types.popitem()\n            typ = dt.__name__\n        else:\n            typ = \"mixed\"\n        return typ\n\n    row_count_tags = [\"#\", \"~\", \"*\"]\n    cols = set(self.columns)\n    for n, tag in product(range(1, 6), row_count_tags):\n        if n * tag not in cols:\n            tag = n * tag\n            break\n\n    if not isinstance(slice_, (slice, type(None))):\n        raise TypeError(f\"slice_ must be None or slice, not {type(slice_)}\")\n    if isinstance(slice_, slice):\n        slc = slice_\n    if slice_ is None:\n        if len(self) &lt;= 20:\n            slc = slice(0, 20, 1)\n        else:\n            slc = None\n\n    n = len(self)\n    if slc:  # either we want slc or we want everything.\n        row_no = list(range(*slc.indices(len(self))))\n        data = {tag: [f\"{i:,}\".rjust(2) for i in row_no]}\n        for name, col in self.columns.items():\n            data[name] = list(chain(iter(col), repeat(blanks, times=n - len(col))))[\n                slc\n            ]\n    else:\n        data = {}\n        j = int(math.ceil(math.log10(n)) / 3) + len(str(n))\n        row_no = (\n            [f\"{i:,}\".rjust(j) for i in range(7)]\n            + [\"...\"]\n            + [f\"{i:,}\".rjust(j) for i in range(n - 7, n)]\n        )\n        data = {tag: row_no}\n\n        for name, col in self.columns.items():\n            if len(col) == n:\n                row = col[:7].tolist() + [\"...\"] + col[-7:].tolist()\n            else:\n                empty = [blanks] * 7\n                head = (col[:7].tolist() + empty)[:7]\n                tail = (col[n - 7 :].tolist() + empty)[-7:]\n                row = head + [\"...\"] + tail\n            data[name] = row\n\n    if dtype:\n        for name, values in data.items():\n            if name in self.columns:\n                col = self.columns[name]\n                values.insert(0, datatype(col))\n            else:\n                values.insert(0, \"row\")\n\n    return data\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.to_ascii","title":"<code>tablite.base.BaseTable.to_ascii(slice_=None, blanks=None, dtype=False)</code>","text":"<p>returns ascii view of table as string.</p> PARAMETER  DESCRIPTION <code>slice_</code> <p>slice to determine table snippet.</p> <p> TYPE: <code>slice</code> DEFAULT: <code>None</code> </p> <code>blanks</code> <p>value for whitespace. Defaults to None.</p> <p> TYPE: <code>str</code> DEFAULT: <code>None</code> </p> <code>dtype</code> <p>adds subheader with datatype for column. Defaults to False.</p> <p> TYPE: <code>bool</code> DEFAULT: <code>False</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def to_ascii(self, slice_=None, blanks=None, dtype=False):\n    \"\"\"returns ascii view of table as string.\n\n    Args:\n        slice_ (slice, optional): slice to determine table snippet.\n        blanks (str, optional): value for whitespace. Defaults to None.\n        dtype (bool, optional): adds subheader with datatype for column. Defaults to False.\n    \"\"\"\n\n    def adjust(v, length):  # PRIVATE FUNCTION\n        \"\"\"whitespace justifies field values based on datatype\"\"\"\n        if v is None:\n            return str(blanks).ljust(length)\n        elif isinstance(v, str):\n            return v.ljust(length)\n        else:\n            return str(v).rjust(length)\n\n    if not self.columns:\n        return str(self)\n\n    d = {}\n    for name, values in self.display_dict(\n        slice_=slice_, blanks=blanks, dtype=dtype\n    ).items():\n        as_text = [str(v) for v in values] + [str(name)]\n        width = max(len(i) for i in as_text)\n        new_name = name.center(width, \" \")\n        if dtype:\n            values[0] = values[0].center(width, \" \")\n        d[new_name] = [adjust(v, width) for v in values]\n\n    rows = dict_to_rows(d)\n    s = []\n    s.append(\"+\" + \"+\".join([\"=\" * len(n) for n in rows[0]]) + \"+\")\n    s.append(\"|\" + \"|\".join(rows[0]) + \"|\")  # column names\n    start = 1\n    if dtype:\n        s.append(\"|\" + \"|\".join(rows[1]) + \"|\")  # datatypes\n        start = 2\n\n    s.append(\"+\" + \"+\".join([\"-\" * len(n) for n in rows[0]]) + \"+\")\n    for row in rows[start:]:\n        s.append(\"|\" + \"|\".join(row) + \"|\")\n    s.append(\"+\" + \"+\".join([\"=\" * len(n) for n in rows[0]]) + \"+\")\n\n    if len(set(len(c) for c in self.columns.values())) != 1:\n        warning = f\"Warning: Columns have different lengths. {blanks} is used as fill value.\"\n        s.append(warning)\n\n    return \"\\n\".join(s)\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.show","title":"<code>tablite.base.BaseTable.show(slice_=None, blanks=None, dtype=False)</code>","text":"<p>prints ascii view of table.</p> PARAMETER  DESCRIPTION <code>slice_</code> <p>slice to determine table snippet.</p> <p> TYPE: <code>slice</code> DEFAULT: <code>None</code> </p> <code>blanks</code> <p>value for whitespace. Defaults to None.</p> <p> TYPE: <code>str</code> DEFAULT: <code>None</code> </p> <code>dtype</code> <p>adds subheader with datatype for column. Defaults to False.</p> <p> TYPE: <code>bool</code> DEFAULT: <code>False</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def show(self, slice_=None, blanks=None, dtype=False):\n    \"\"\"prints ascii view of table.\n\n    Args:\n        slice_ (slice, optional): slice to determine table snippet.\n        blanks (str, optional): value for whitespace. Defaults to None.\n        dtype (bool, optional): adds subheader with datatype for column. Defaults to False.\n    \"\"\"\n    print(self.to_ascii(slice_=slice_, blanks=blanks, dtype=dtype))\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.to_dict","title":"<code>tablite.base.BaseTable.to_dict(columns=None, slice_=None)</code>","text":"<p>columns: list of column names. Default is None == all columns. slice_: slice. Default is None == all rows.</p> <p>returns: dict with columns as keys and lists of values.</p> <p>Example:</p> <pre><code>&gt;&gt;&gt; t.show()\n+===+===+===+\n| # | a | b |\n|row|int|int|\n+---+---+---+\n| 0 |  1|  3|\n| 1 |  2|  4|\n+===+===+===+\n&gt;&gt;&gt; t.to_dict()\n{'a':[1,2], 'b':[3,4]}\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def to_dict(self, columns=None, slice_=None):\n    \"\"\"\n    columns: list of column names. Default is None == all columns.\n    slice_: slice. Default is None == all rows.\n\n    returns: dict with columns as keys and lists of values.\n\n    Example:\n    ```\n    &gt;&gt;&gt; t.show()\n    +===+===+===+\n    | # | a | b |\n    |row|int|int|\n    +---+---+---+\n    | 0 |  1|  3|\n    | 1 |  2|  4|\n    +===+===+===+\n    &gt;&gt;&gt; t.to_dict()\n    {'a':[1,2], 'b':[3,4]}\n    ```\n\n    \"\"\"\n    if slice_ is None:\n        slice_ = slice(0, len(self))\n    assert isinstance(slice_, slice)\n\n    if columns is None:\n        columns = list(self.columns.keys())\n    if not isinstance(columns, list):\n        raise TypeError(\"expected columns as list of strings\")\n\n    return {name: list(self.columns[name][slice_]) for name in columns}\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.as_json_serializable","title":"<code>tablite.base.BaseTable.as_json_serializable(row_count='row id', start_on=1, columns=None, slice_=None)</code>","text":"<p>provides a JSON compatible format of the table.</p> PARAMETER  DESCRIPTION <code>row_count</code> <p>Label for row counts. Defaults to \"row id\".</p> <p> TYPE: <code>str</code> DEFAULT: <code>'row id'</code> </p> <code>start_on</code> <p>row counts starts by default on 1.</p> <p> TYPE: <code>int</code> DEFAULT: <code>1</code> </p> <code>columns</code> <p>Column names. Defaults to None which returns all columns.</p> <p> TYPE: <code>list of str</code> DEFAULT: <code>None</code> </p> <code>slice_</code> <p>selector. Defaults to None which returns [:]</p> <p> TYPE: <code>slice</code> DEFAULT: <code>None</code> </p> RETURNS DESCRIPTION <p>JSON serializable dict: All python datatypes have been converted to JSON compliant data.</p> Source code in <code>tablite/base.py</code> <pre><code>def as_json_serializable(\n    self, row_count=\"row id\", start_on=1, columns=None, slice_=None\n):\n    \"\"\"provides a JSON compatible format of the table.\n\n    Args:\n        row_count (str, optional): Label for row counts. Defaults to \"row id\".\n        start_on (int, optional): row counts starts by default on 1.\n        columns (list of str, optional): Column names.\n            Defaults to None which returns all columns.\n        slice_ (slice, optional): selector. Defaults to None which returns [:]\n\n    Returns:\n        JSON serializable dict: All python datatypes have been converted to JSON compliant data.\n    \"\"\"\n    if slice_ is None:\n        slice_ = slice(0, len(self))\n\n    assert isinstance(slice_, slice)\n    new = {\"columns\": {}, \"total_rows\": len(self)}\n    if row_count is not None:\n        new[\"columns\"][row_count] = [\n            i + start_on for i in range(*slice_.indices(len(self)))\n        ]\n\n    d = self.to_dict(columns, slice_=slice_)\n    for k, data in d.items():\n        new_k = unique_name(\n            k, new[\"columns\"]\n        )  # used to avoid overwriting the `row id` key.\n        new[\"columns\"][new_k] = [\n            DataTypes.to_json(v) for v in data\n        ]  # deal with non-json datatypes.\n    return new\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.index","title":"<code>tablite.base.BaseTable.index(*args)</code>","text":"<p>param: *args: column names returns multikey index on the columns as d[(key tuple, )] = {index1, index2, ...}</p> <p>Examples:</p> <pre><code>&gt;&gt;&gt; table6 = Table()\n&gt;&gt;&gt; table6['A'] = ['Alice', 'Bob', 'Bob', 'Ben', 'Charlie', 'Ben','Albert']\n&gt;&gt;&gt; table6['B'] = ['Alison', 'Marley', 'Dylan', 'Affleck', 'Hepburn', 'Barnes', 'Einstein']\n</code></pre> <pre><code>&gt;&gt;&gt; table6.index('A')  # single key.\n{('Alice',): [0],\n ('Bob',): [1, 2],\n ('Ben',): [3, 5],\n ('Charlie',): [4],\n ('Albert',): [6]})\n</code></pre> <pre><code>&gt;&gt;&gt; table6.index('A', 'B')  # multiple keys.\n{('Alice', 'Alison'): [0],\n ('Bob', 'Marley'): [1],\n ('Bob', 'Dylan'): [2],\n ('Ben', 'Affleck'): [3],\n ('Charlie', 'Hepburn'): [4],\n ('Ben', 'Barnes'): [5],\n ('Albert', 'Einstein'): [6]})\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def index(self, *args):\n    \"\"\"\n    param: *args: column names\n    returns multikey index on the columns as d[(key tuple, )] = {index1, index2, ...}\n\n    Examples:\n        ```\n        &gt;&gt;&gt; table6 = Table()\n        &gt;&gt;&gt; table6['A'] = ['Alice', 'Bob', 'Bob', 'Ben', 'Charlie', 'Ben','Albert']\n        &gt;&gt;&gt; table6['B'] = ['Alison', 'Marley', 'Dylan', 'Affleck', 'Hepburn', 'Barnes', 'Einstein']\n        ```\n\n        ```\n        &gt;&gt;&gt; table6.index('A')  # single key.\n        {('Alice',): [0],\n         ('Bob',): [1, 2],\n         ('Ben',): [3, 5],\n         ('Charlie',): [4],\n         ('Albert',): [6]})\n        ```\n\n        ```\n        &gt;&gt;&gt; table6.index('A', 'B')  # multiple keys.\n        {('Alice', 'Alison'): [0],\n         ('Bob', 'Marley'): [1],\n         ('Bob', 'Dylan'): [2],\n         ('Ben', 'Affleck'): [3],\n         ('Charlie', 'Hepburn'): [4],\n         ('Ben', 'Barnes'): [5],\n         ('Albert', 'Einstein'): [6]})\n        ```\n\n    \"\"\"\n    idx = defaultdict(list)\n    iterators = [iter(self.columns[c]) for c in args]\n    for ix, key in enumerate(zip(*iterators)):\n        key = tuple(numpy_to_python(k) for k in key)\n        idx[key].append(ix)\n    return idx\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.unique_index","title":"<code>tablite.base.BaseTable.unique_index(*args, tqdm=_tqdm)</code>","text":"<p>generates the index of unique rows given a list of column names</p> PARAMETER  DESCRIPTION <code>*args</code> <p>columns names</p> <p> TYPE: <code>any</code> DEFAULT: <code>()</code> </p> <code>tqdm</code> <p>Defaults to _tqdm.</p> <p> TYPE: <code>tqdm</code> DEFAULT: <code>tqdm</code> </p> RETURNS DESCRIPTION <p>np.array(int64): indices of unique records.</p> Source code in <code>tablite/base.py</code> <pre><code>def unique_index(self, *args, tqdm=_tqdm):\n    \"\"\"generates the index of unique rows given a list of column names\n\n    Args:\n        *args (any): columns names\n        tqdm (tqdm, optional): Defaults to _tqdm.\n\n    Returns:\n        np.array(int64): indices of unique records.\n    \"\"\"\n    if not args:\n        raise ValueError(\"*args (column names) is required\")\n    seen = set()\n    unique = set()\n    iterators = [iter(self.columns[c]) for c in args]\n    for ix, key in tqdm(enumerate(zip(*iterators)), disable=Config.TQDM_DISABLE):\n        key_hash = hash(tuple(numpy_to_python(k) for k in key))\n        if key_hash in seen:\n            continue\n        else:\n            seen.add(key_hash)\n            unique.add(ix)\n    return np.array(sorted(unique))\n</code></pre>"},{"location":"reference/base/#tablite.base-functions","title":"Functions","text":""},{"location":"reference/base/#tablite.base.register","title":"<code>tablite.base.register(path)</code>","text":"<p>registers path in file_registry</p> <p>The method is used by Table during init when the working directory path is set, so that python can clean all temporary files up at exit.</p> PARAMETER  DESCRIPTION <code>path</code> <p>typically tmp/tablite-tmp/PID-{os.getpid()}</p> <p> TYPE: <code>Path</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def register(path):\n    \"\"\"registers path in file_registry\n\n    The method is used by Table during init when the working directory path\n    is set, so that python can clean all temporary files up at exit.\n\n    Args:\n        path (Path): typically tmp/tablite-tmp/PID-{os.getpid()}\n    \"\"\"\n    global file_registry\n    file_registry.add(path)\n</code></pre>"},{"location":"reference/base/#tablite.base.shutdown","title":"<code>tablite.base.shutdown()</code>","text":"<p>method to clean up temporary files triggered at shutdown.</p> Source code in <code>tablite/base.py</code> <pre><code>def shutdown():\n    \"\"\"method to clean up temporary files triggered at shutdown.\"\"\"\n    for path in file_registry:\n        if Config.pid in str(path):  # safety feature to prevent rm -rf /\n            log.debug(f\"shutdown: running rmtree({path})\")\n            shutil.rmtree(path)\n</code></pre>"},{"location":"reference/config/","title":"Config","text":""},{"location":"reference/config/#tablite.config","title":"<code>tablite.config</code>","text":""},{"location":"reference/config/#tablite.config-classes","title":"Classes","text":""},{"location":"reference/config/#tablite.config.Config","title":"<code>tablite.config.Config</code>","text":"<p>             Bases: <code>object</code></p> <p>Config class for Tablite Tables.</p> <p>The default location for the storage is loaded as</p> <pre><code>Config.workdir = pathlib.Path(os.environ.get(\"TABLITE_TMPDIR\", f\"{tempfile.gettempdir()}/tablite-tmp\"))\n</code></pre> <p>to overwrite, first import the config class, then set the new workdir.</p> <pre><code>&gt;&gt;&gt; from tablite import config\n&gt;&gt;&gt; from pathlib import Path\n&gt;&gt;&gt; config.workdir = Path(\"/this/new/location\")\n</code></pre> <p>the new path will now be used for every new table.</p> <p>PAGE_SIZE = 1_000_000 sets the page size limit.</p> <p>Multiprocessing is enabled in one of three modes: AUTO = \"auto\" FALSE = \"sp\" FORCE = \"mp\"</p> <p>MULTIPROCESSING_MODE = AUTO  is default.</p> <p>SINGLE_PROCESSING_LIMIT = 1_000_000 when the number of fields (rows x columns) exceed this value, multiprocessing is used.</p>"},{"location":"reference/config/#tablite.config.Config-attributes","title":"Attributes","text":""},{"location":"reference/config/#tablite.config.Config.USE_NIMPORTER","title":"<code>tablite.config.Config.USE_NIMPORTER = os.environ.get('USE_NIMPORTER', 'true').lower() in ['1', 't', 'true', 'y', 'yes']</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.ALLOW_CSV_READER_FALLTHROUGH","title":"<code>tablite.config.Config.ALLOW_CSV_READER_FALLTHROUGH = os.environ.get('ALLOW_CSV_READER_FALLTHROUGH', 'true').lower() in ['1', 't', 'true', 'y', 'yes']</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.NIM_SUPPORTED_CONV_TYPES","title":"<code>tablite.config.Config.NIM_SUPPORTED_CONV_TYPES = ['Windows-1252', 'ISO-8859-1']</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.workdir","title":"<code>tablite.config.Config.workdir = pathlib.Path(os.environ.get('TABLITE_TMPDIR', f'{tempfile.gettempdir()}/tablite-tmp'))</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.pid","title":"<code>tablite.config.Config.pid = f'pid-{os.getpid()}'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.PAGE_SIZE","title":"<code>tablite.config.Config.PAGE_SIZE = 1000000</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.ENCODING","title":"<code>tablite.config.Config.ENCODING = 'UTF-8'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.DISK_LIMIT","title":"<code>tablite.config.Config.DISK_LIMIT = int(10000000000.0)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":"<p>10e9 (10Gb) on 100 Gb disk means raise at 90 Gb disk usage. if DISK_LIMIT &lt;= 0, the check is turned off.</p>"},{"location":"reference/config/#tablite.config.Config.SINGLE_PROCESSING_LIMIT","title":"<code>tablite.config.Config.SINGLE_PROCESSING_LIMIT = 1000000</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":"<p>when the number of fields (rows x columns) exceed this value, multiprocessing is used.</p>"},{"location":"reference/config/#tablite.config.Config.vpus","title":"<code>tablite.config.Config.vpus = max(os.cpu_count() - 1, 1)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.AUTO","title":"<code>tablite.config.Config.AUTO = 'auto'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.FALSE","title":"<code>tablite.config.Config.FALSE = 'sp'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.FORCE","title":"<code>tablite.config.Config.FORCE = 'mp'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.MULTIPROCESSING_MODE","title":"<code>tablite.config.Config.MULTIPROCESSING_MODE = AUTO</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.TQDM_DISABLE","title":"<code>tablite.config.Config.TQDM_DISABLE = False</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config-functions","title":"Functions","text":""},{"location":"reference/config/#tablite.config.Config.reset","title":"<code>tablite.config.Config.reset()</code>  <code>classmethod</code>","text":"<p>Resets the config class to original values.</p> Source code in <code>tablite/config.py</code> <pre><code>@classmethod\ndef reset(cls):\n    \"\"\"Resets the config class to original values.\"\"\"\n    for k, v in _default_values.items():\n        setattr(Config, k, v)\n</code></pre>"},{"location":"reference/config/#tablite.config.Config.page_steps","title":"<code>tablite.config.Config.page_steps(length)</code>  <code>classmethod</code>","text":"<p>an iterator that yield start and end in page sizes</p> YIELDS DESCRIPTION <code>tuple</code> <p>start:int, end:int</p> Source code in <code>tablite/config.py</code> <pre><code>@classmethod\ndef page_steps(cls, length):\n    \"\"\"an iterator that yield start and end in page sizes\n\n    Yields:\n        tuple: start:int, end:int\n    \"\"\"\n    start, end = 0, 0\n    for _ in range(0, length + 1, cls.PAGE_SIZE):\n        start, end = end, min(end + cls.PAGE_SIZE, length)\n        yield start, end\n        if end == length:\n            return\n</code></pre>"},{"location":"reference/core/","title":"Core","text":""},{"location":"reference/core/#tablite.core","title":"<code>tablite.core</code>","text":""},{"location":"reference/core/#tablite.core-attributes","title":"Attributes","text":""},{"location":"reference/core/#tablite.core.log","title":"<code>tablite.core.log = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/core/#tablite.core-classes","title":"Classes","text":""},{"location":"reference/core/#tablite.core.Table","title":"<code>tablite.core.Table(columns=None, headers=None, rows=None, _path=None)</code>","text":"<p>             Bases: <code>BaseTable</code></p> <p>creates Table</p> PARAMETER  DESCRIPTION <code>EITHER</code> <p>columns (dict, optional): dict with column names as keys, values as lists. Example: t = Table(columns={\"a\": [1, 2], \"b\": [3, 4]})</p> <p> </p> Source code in <code>tablite/core.py</code> <pre><code>def __init__(self, columns=None, headers=None, rows=None, _path=None) -&gt; None:\n    \"\"\"creates Table\n\n    Args:\n        EITHER:\n            columns (dict, optional): dict with column names as keys, values as lists.\n            Example: t = Table(columns={\"a\": [1, 2], \"b\": [3, 4]})\n        OR\n            headers (list of strings, optional): list of column names.\n            rows (list of tuples or lists, optional): values for columns\n            Example: t = Table(headers=[\"a\", \"b\"], rows=[[1,3], [2,4]])\n    \"\"\"\n    super().__init__(columns, headers, rows, _path)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table-attributes","title":"Attributes","text":""},{"location":"reference/core/#tablite.core.Table.path","title":"<code>tablite.core.Table.path = _path</code>  <code>instance-attribute</code>","text":""},{"location":"reference/core/#tablite.core.Table.columns","title":"<code>tablite.core.Table.columns = {}</code>  <code>instance-attribute</code>","text":""},{"location":"reference/core/#tablite.core.Table.rows","title":"<code>tablite.core.Table.rows</code>  <code>property</code>","text":"<p>enables row based iteration in python types.</p> <p>Example:</p> <pre><code>for row in Table.rows:\n    print(row)\n</code></pre> <p>Yields:     tuple: values is same order as columns.</p>"},{"location":"reference/core/#tablite.core.Table-functions","title":"Functions","text":""},{"location":"reference/core/#tablite.core.Table.__str__","title":"<code>tablite.core.Table.__str__()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __str__(self):  # USER FUNCTION.\n    return f\"{self.__class__.__name__}({len(self.columns):,} columns, {len(self):,} rows)\"\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.__repr__","title":"<code>tablite.core.Table.__repr__()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __repr__(self):\n    return self.__str__()\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.nbytes","title":"<code>tablite.core.Table.nbytes()</code>","text":"<p>finds the total bytes of the table on disk</p> RETURNS DESCRIPTION <code>tuple</code> <p>int: real bytes used on disk int: total bytes used if flattened</p> Source code in <code>tablite/base.py</code> <pre><code>def nbytes(self):  # USER FUNCTION.\n    \"\"\"finds the total bytes of the table on disk\n\n    Returns:\n        tuple:\n            int: real bytes used on disk\n            int: total bytes used if flattened\n    \"\"\"\n    real = {}\n    total = 0\n    for column in self.columns.values():\n        for page in set(column.pages):\n            real[page] = page.path.stat().st_size\n        for page in column.pages:\n            total += real[page]\n    return sum(real.values()), total\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.items","title":"<code>tablite.core.Table.items()</code>","text":"<p>returns table as dict</p> RETURNS DESCRIPTION <code>dict</code> <p>Table as dict <code>{column_name: [values], ...}</code></p> Source code in <code>tablite/base.py</code> <pre><code>def items(self):  # USER FUNCTION.\n    \"\"\"returns table as dict\n\n    Returns:\n        dict: Table as dict `{column_name: [values], ...}`\n    \"\"\"\n    return {\n        name: column[:].tolist() for name, column in self.columns.items()\n    }.items()\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.__delitem__","title":"<code>tablite.core.Table.__delitem__(key)</code>","text":"<p>Examples:</p> <pre><code>&gt;&gt;&gt; del table['a']  # removes column 'a'\n&gt;&gt;&gt; del table[-3:]  # removes last 3 rows from all columns.\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def __delitem__(self, key):  # USER FUNCTION.\n    \"\"\"\n    Examples:\n    ```\n    &gt;&gt;&gt; del table['a']  # removes column 'a'\n    &gt;&gt;&gt; del table[-3:]  # removes last 3 rows from all columns.\n    ```\n    \"\"\"\n    if isinstance(key, (int, slice)):\n        for column in self.columns.values():\n            del column[key]\n    elif key in self.columns:\n        del self.columns[key]\n    else:\n        raise KeyError(f\"Key not found: {key}\")\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.__setitem__","title":"<code>tablite.core.Table.__setitem__(key, value)</code>","text":"<p>table behaves like a dict. Args:     key (str or hashable): column name     value (iterable): list, tuple or nd.array with values.</p> <p>As Table now accepts the keyword <code>columns</code> as a dict:</p> <pre><code>&gt;&gt;&gt; t = Table(columns={'b':[4,5,6], 'c':[7,8,9]})\n</code></pre> <p>and the header/data combinations:</p> <pre><code>&gt;&gt;&gt; t = Table(header=['b','c'], data=[[4,5,6],[7,8,9]])\n</code></pre> <p>This has the side-benefit that tuples now can be used as headers.</p> Source code in <code>tablite/base.py</code> <pre><code>def __setitem__(self, key, value):  # USER FUNCTION\n    \"\"\"table behaves like a dict.\n    Args:\n        key (str or hashable): column name\n        value (iterable): list, tuple or nd.array with values.\n\n    As Table now accepts the keyword `columns` as a dict:\n    ```\n    &gt;&gt;&gt; t = Table(columns={'b':[4,5,6], 'c':[7,8,9]})\n    ```\n    and the header/data combinations:\n    ```\n    &gt;&gt;&gt; t = Table(header=['b','c'], data=[[4,5,6],[7,8,9]])\n    ```\n    This has the side-benefit that tuples now can be used as headers.\n    \"\"\"\n    if value is None:\n        self.columns[key] = Column(self.path, value=None)\n    elif isinstance(value, (list, tuple)):\n        value = list_to_np_array(value)\n        self.columns[key] = Column(self.path, value)\n    elif isinstance(value, (np.ndarray)):\n        self.columns[key] = Column(self.path, value)\n    elif isinstance(value, Column):\n        self.columns[key] = value\n    else:\n        raise TypeError(f\"{type(value)} not supported.\")\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.__getitem__","title":"<code>tablite.core.Table.__getitem__(keys)</code>","text":"<p>Enables selection of columns and rows</p> PARAMETER  DESCRIPTION <code>keys</code> <p> TYPE: <code>column name, integer or slice</code> </p> <code>Examples</code> <p> </p> <code>&gt;&gt;&gt;</code> <p>10]                        selects first 10 rows from all columns</p> <p> TYPE: <code>table[</code> </p> <code>&gt;&gt;&gt;</code> <p>20:3] selects column 'b' and 'c' and 'a' twice for a slice.</p> <p> TYPE: <code>table['b', 'a', 'a', 'c', 2</code> </p> <p>Raises:     KeyError: if key is not found.     TypeError: if key is not a string, integer or slice.</p> RETURNS DESCRIPTION <code>Table</code> <p>returns columns in same order as selection.</p> Source code in <code>tablite/base.py</code> <pre><code>def __getitem__(self, keys):  # USER FUNCTION\n    \"\"\"\n    Enables selection of columns and rows\n\n    Args:\n        keys (column name, integer or slice):\n        Examples:\n        ```\n        &gt;&gt;&gt; table['a']                        selects column 'a'\n        &gt;&gt;&gt; table[3]                          selects row 3 as a tuple.\n        &gt;&gt;&gt; table[:10]                        selects first 10 rows from all columns\n        &gt;&gt;&gt; table['a','b', slice(3,20,2)]     selects a slice from columns 'a' and 'b'\n        &gt;&gt;&gt; table['b', 'a', 'a', 'c', 2:20:3] selects column 'b' and 'c' and 'a' twice for a slice.\n        &gt;&gt;&gt; table[('b', 'a', 'a', 'c')]       selects columns 'b', 'a', 'a', and 'c' using a tuple.\n        ```\n    Raises:\n        KeyError: if key is not found.\n        TypeError: if key is not a string, integer or slice.\n\n    Returns:\n        Table: returns columns in same order as selection.\n    \"\"\"\n\n    if not isinstance(keys, tuple):\n        if isinstance(keys, list):\n            keys = tuple(keys)\n        else:\n            keys = (keys,)\n    if isinstance(keys[0], tuple):\n        keys = tuple(list(chain(*keys)))\n\n    integers = [i for i in keys if isinstance(i, int)]\n    if len(integers) == len(keys) == 1:  # return a single tuple.\n        keys = [slice(keys[0])]\n\n    column_names = [i for i in keys if isinstance(i, str)]\n    column_names = list(self.columns) if not column_names else column_names\n    not_found = [name for name in column_names if name not in self.columns]\n    if not_found:\n        raise KeyError(f\"keys not found: {', '.join(not_found)}\")\n\n    slices = [i for i in keys if isinstance(i, slice)]\n    slc = slice(0, len(self)) if not slices else slices[0]\n\n    if (\n        len(slices) == 0 and len(column_names) == 1\n    ):  # e.g. tbl['a'] or tbl['a'][:10]\n        col = self.columns[column_names[0]]\n        if slices:\n            return col[slc]  # return slice from column as list of values\n        else:\n            return col  # return whole column\n\n    elif len(integers) == 1:  # return a single tuple.\n        row_no = integers[0]\n        slc = slice(row_no, row_no + 1)\n        return tuple(self.columns[name][slc].tolist()[0] for name in column_names)\n\n    elif not slices:  # e.g. new table with N whole columns.\n        return self.__class__(\n            columns={name: self.columns[name] for name in column_names}\n        )\n\n    else:  # e.g. new table from selection of columns and slices.\n        t = self.__class__()\n        for name in column_names:\n            column = self.columns[name]\n\n            new_column = Column(t.path)  # create new Column.\n            for item in column.getpages(slc):\n                if isinstance(item, np.ndarray):\n                    new_column.extend(item)  # extend subslice (expensive)\n                elif isinstance(item, SimplePage):\n                    new_column.pages.append(item)  # extend page (cheap)\n                else:\n                    raise TypeError(f\"Bad item: {item}\")\n\n            # below:\n            # set the new column directly on t.columns.\n            # Do not use t[name] as that triggers __setitem__ again.\n            t.columns[name] = new_column\n\n        return t\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.__len__","title":"<code>tablite.core.Table.__len__()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __len__(self):  # USER FUNCTION.\n    if not self.columns:\n        return 0\n    return max(len(c) for c in self.columns.values())\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.__eq__","title":"<code>tablite.core.Table.__eq__(other) -&gt; bool</code>","text":"<p>Determines if two tables have identical content.</p> PARAMETER  DESCRIPTION <code>other</code> <p>table for comparison</p> <p> TYPE: <code>Table</code> </p> RETURNS DESCRIPTION <code>bool</code> <p>True if tables are identical.</p> <p> TYPE: <code>bool</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def __eq__(self, other) -&gt; bool:  # USER FUNCTION.\n    \"\"\"Determines if two tables have identical content.\n\n    Args:\n        other (Table): table for comparison\n\n    Returns:\n        bool: True if tables are identical.\n    \"\"\"\n    if isinstance(other, dict):\n        return self.items() == other.items()\n    if not isinstance(other, BaseTable):\n        return False\n    if id(self) == id(other):\n        return True\n    if len(self) != len(other):\n        return False\n    if len(self) == len(other) == 0:\n        return True\n    if self.columns.keys() != other.columns.keys():\n        return False\n    for name, col in self.columns.items():\n        if not (col == other.columns[name]):\n            return False\n    return True\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.clear","title":"<code>tablite.core.Table.clear()</code>","text":"<p>clears the table. Like dict().clear()</p> Source code in <code>tablite/base.py</code> <pre><code>def clear(self):  # USER FUNCTION.\n    \"\"\"clears the table. Like dict().clear()\"\"\"\n    self.columns.clear()\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.save","title":"<code>tablite.core.Table.save(path, compression_method=zipfile.ZIP_DEFLATED, compression_level=1)</code>","text":"<p>saves table to compressed tpz file.</p> PARAMETER  DESCRIPTION <code>path</code> <p>file destination.</p> <p> TYPE: <code>Path</code> </p> <code>compression_method</code> <p>See zipfile compression methods. Defaults to ZIP_DEFLATED.</p> <p> DEFAULT: <code>ZIP_DEFLATED</code> </p> <code>compression_level</code> <p>See zipfile compression levels. Defaults to 1.</p> <p> DEFAULT: <code>1</code> </p> <p>The file format is as follows: .tpz is a gzip archive with table metadata captured as table.yml and the necessary set of pages saved as .npy files.</p> <p>The zip contains table.yml which provides an overview of the data:</p> <pre><code>--------------------------------------\n%YAML 1.2                              yaml version\ncolumns:                               start of columns section.\n    name: \u201c\u5217 1\u201d                       name of column 1.\n        pages: [p1b1, p1b2]            list of pages in column 1.\n    name: \u201c\u5217 2\u201d                       name of column 2\n        pages: [p2b1, p2b2]            list of pages in column 2.\n----------------------------------------\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def save(\n    self, path, compression_method=zipfile.ZIP_DEFLATED, compression_level=1\n):  # USER FUNCTION.\n    \"\"\"saves table to compressed tpz file.\n\n    Args:\n        path (Path): file destination.\n        compression_method: See zipfile compression methods. Defaults to ZIP_DEFLATED.\n        compression_level: See zipfile compression levels. Defaults to 1.\n        The default settings produce 80% compression at 10% slowdown.\n\n    The file format is as follows:\n    .tpz is a gzip archive with table metadata captured as table.yml\n    and the necessary set of pages saved as .npy files.\n\n    The zip contains table.yml which provides an overview of the data:\n    ```\n    --------------------------------------\n    %YAML 1.2                              yaml version\n    columns:                               start of columns section.\n        name: \u201c\u5217 1\u201d                       name of column 1.\n            pages: [p1b1, p1b2]            list of pages in column 1.\n        name: \u201c\u5217 2\u201d                       name of column 2\n            pages: [p2b1, p2b2]            list of pages in column 2.\n    ----------------------------------------\n    ```\n    \"\"\"\n    if isinstance(path, str):\n        path = Path(path)\n    type_check(path, Path)\n    if path.is_dir():\n        raise TypeError(f\"filename needed: {path}\")\n    if path.suffix != \".tpz\":\n        path = path.parent / (path.parts[-1] + \".tpz\")\n\n    # create yaml document\n    _page_counter = 0\n    d = {}\n    cols = {}\n    for name, col in self.columns.items():\n        type_check(col, Column)\n        cols[name] = {\"pages\": [p.path.name for p in col.pages]}\n        _page_counter += len(col.pages)\n    d[\"columns\"] = cols\n    yml = yaml.safe_dump(\n        d, sort_keys=False, allow_unicode=True, default_flow_style=None\n    )\n\n    _file_counter = 0\n    with zipfile.ZipFile(\n        path, \"w\", compression=compression_method, compresslevel=compression_level\n    ) as f:\n        log.debug(f\"writing .tpz to {path} with\\n{yml}\")\n        f.writestr(\"table.yml\", yml)\n        for name, col in self.columns.items():\n            for page in set(\n                col.pages\n            ):  # set of pages! remember t *= 1000 repeats t 1000x\n                with open(page.path, \"rb\", buffering=0) as raw_io:\n                    f.writestr(page.path.name, raw_io.read())\n                _file_counter += 1\n                log.debug(f\"adding Page {page.path}\")\n\n        _fields = len(self) * len(self.columns)\n        _avg = _fields // _page_counter\n        log.debug(\n            f\"Wrote {_fields:,} on {_page_counter:,} pages in {_file_counter} files: {_avg} fields/page\"\n        )\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.load","title":"<code>tablite.core.Table.load(path, tqdm=_tqdm)</code>  <code>classmethod</code>","text":"<p>loads a table from .tpz file. See also Table.save for details on the file format.</p> PARAMETER  DESCRIPTION <code>path</code> <p>source file</p> <p> TYPE: <code>Path</code> </p> RETURNS DESCRIPTION <code>Table</code> <p>table in read-only mode.</p> Source code in <code>tablite/base.py</code> <pre><code>@classmethod\ndef load(cls, path, tqdm=_tqdm):  # USER FUNCTION.\n    \"\"\"loads a table from .tpz file.\n    See also Table.save for details on the file format.\n\n    Args:\n        path (Path): source file\n\n    Returns:\n        Table: table in read-only mode.\n    \"\"\"\n    path = Path(path)\n    log.debug(f\"loading {path}\")\n    with zipfile.ZipFile(path, \"r\") as f:\n        yml = f.read(\"table.yml\")\n        metadata = yaml.safe_load(yml)\n        t = cls()\n\n        page_count = sum([len(c[\"pages\"]) for c in metadata[\"columns\"].values()])\n\n        with tqdm(\n            total=page_count,\n            desc=f\"loading '{path.name}' file\",\n            disable=Config.TQDM_DISABLE,\n        ) as pbar:\n            for name, d in metadata[\"columns\"].items():\n                column = Column(t.path)\n                for page in d[\"pages\"]:\n                    bytestream = io.BytesIO(f.read(page))\n                    data = np.load(bytestream, allow_pickle=True, fix_imports=False)\n                    column.extend(data)\n                    pbar.update(1)\n                t.columns[name] = column\n    update_access_time(path)\n    return t\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.copy","title":"<code>tablite.core.Table.copy()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def copy(self):\n    cls = type(self)\n    t = cls()\n    for name, column in self.columns.items():\n        new = Column(t.path)\n        new.pages = column.pages[:]\n        t.columns[name] = new\n    return t\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.__imul__","title":"<code>tablite.core.Table.__imul__(other)</code>","text":"<p>Repeats instance of table N times.</p> <p>Like list: <code>t = t * N</code></p> PARAMETER  DESCRIPTION <code>other</code> <p>multiplier</p> <p> TYPE: <code>int</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def __imul__(self, other):\n    \"\"\"Repeats instance of table N times.\n\n    Like list: `t = t * N`\n\n    Args:\n        other (int): multiplier\n    \"\"\"\n    if not (isinstance(other, int) and other &gt; 0):\n        raise TypeError(\n            f\"a table can be repeated an integer number of times, not {type(other)} number of times\"\n        )\n    for col in self.columns.values():\n        col *= other\n    return self\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.__mul__","title":"<code>tablite.core.Table.__mul__(other)</code>","text":"<p>Repeat table N times. Like list: <code>new = old * N</code></p> PARAMETER  DESCRIPTION <code>other</code> <p>multiplier</p> <p> TYPE: <code>int</code> </p> RETURNS DESCRIPTION <p>Table</p> Source code in <code>tablite/base.py</code> <pre><code>def __mul__(self, other):\n    \"\"\"Repeat table N times.\n    Like list: `new = old * N`\n\n    Args:\n        other (int): multiplier\n\n    Returns:\n        Table\n    \"\"\"\n    new = self.copy()\n    return new.__imul__(other)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.__iadd__","title":"<code>tablite.core.Table.__iadd__(other)</code>","text":"<p>Concatenates tables with same column names.</p> <p>Like list: <code>table_1 += table_2</code></p> RAISES DESCRIPTION <code>ValueError</code> <p>If column names don't match.</p> RETURNS DESCRIPTION <code>None</code> <p>self is updated.</p> Source code in <code>tablite/base.py</code> <pre><code>def __iadd__(self, other):\n    \"\"\"Concatenates tables with same column names.\n\n    Like list: `table_1 += table_2`\n\n    Args:\n        other (Table)\n\n    Raises:\n        ValueError: If column names don't match.\n\n    Returns:\n        None: self is updated.\n    \"\"\"\n    type_check(other, BaseTable)\n    for name in self.columns.keys():\n        if name not in other.columns:\n            raise ValueError(f\"{name} not in other\")\n    for name in other.columns.keys():\n        if name not in self.columns:\n            raise ValueError(f\"{name} missing from self\")\n\n    for name, column in self.columns.items():\n        other_col = other.columns.get(name, None)\n        column.pages.extend(other_col.pages[:])\n    return self\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.__add__","title":"<code>tablite.core.Table.__add__(other)</code>","text":"<p>Concatenates tables with same column names.</p> <p>Like list: <code>table_3 = table_1 + table_2</code></p> RAISES DESCRIPTION <code>ValueError</code> <p>If column names don't match.</p> RETURNS DESCRIPTION <p>Table</p> Source code in <code>tablite/base.py</code> <pre><code>def __add__(self, other):\n    \"\"\"Concatenates tables with same column names.\n\n    Like list: `table_3 = table_1 + table_2`\n\n    Args:\n        other (Table)\n\n    Raises:\n        ValueError: If column names don't match.\n\n    Returns:\n        Table\n    \"\"\"\n    type_check(other, BaseTable)\n    cp = self.copy()\n    cp += other\n    return cp\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.add_rows","title":"<code>tablite.core.Table.add_rows(*args, **kwargs)</code>","text":"<p>its more efficient to add many rows at once.</p> <p>if both args and kwargs, then args are added first, followed by kwargs.</p> <p>supported cases:</p> <pre><code>&gt;&gt;&gt; t = Table()\n&gt;&gt;&gt; t.add_columns('row','A','B','C')\n&gt;&gt;&gt; t.add_rows(1, 1, 2, 3)                              # (1) individual values as args\n&gt;&gt;&gt; t.add_rows([2, 1, 2, 3])                            # (2) list of values as args\n&gt;&gt;&gt; t.add_rows((3, 1, 2, 3))                            # (3) tuple of values as args\n&gt;&gt;&gt; t.add_rows(*(4, 1, 2, 3))                           # (4) unpacked tuple becomes arg like (1)\n&gt;&gt;&gt; t.add_rows(row=5, A=1, B=2, C=3)                    # (5) kwargs\n&gt;&gt;&gt; t.add_rows(**{'row': 6, 'A': 1, 'B': 2, 'C': 3})    # (6) dict / json interpreted a kwargs\n&gt;&gt;&gt; t.add_rows((7, 1, 2, 3), (8, 4, 5, 6))              # (7) two (or more) tuples as args\n&gt;&gt;&gt; t.add_rows([9, 1, 2, 3], [10, 4, 5, 6])             # (8) two or more lists as rgs\n&gt;&gt;&gt; t.add_rows(\n    {'row': 11, 'A': 1, 'B': 2, 'C': 3},\n    {'row': 12, 'A': 4, 'B': 5, 'C': 6}\n    )                                                   # (9) two (or more) dicts as args - roughly comma sep'd json.\n&gt;&gt;&gt; t.add_rows( *[\n    {'row': 13, 'A': 1, 'B': 2, 'C': 3},\n    {'row': 14, 'A': 1, 'B': 2, 'C': 3}\n    ])                                                  # (10) list of dicts as args\n&gt;&gt;&gt; t.add_rows(row=[15,16], A=[1,1], B=[2,2], C=[3,3])  # (11) kwargs with lists as values\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def add_rows(self, *args, **kwargs):\n    \"\"\"its more efficient to add many rows at once.\n\n    if both args and kwargs, then args are added first, followed by kwargs.\n\n    supported cases:\n    ```\n    &gt;&gt;&gt; t = Table()\n    &gt;&gt;&gt; t.add_columns('row','A','B','C')\n    &gt;&gt;&gt; t.add_rows(1, 1, 2, 3)                              # (1) individual values as args\n    &gt;&gt;&gt; t.add_rows([2, 1, 2, 3])                            # (2) list of values as args\n    &gt;&gt;&gt; t.add_rows((3, 1, 2, 3))                            # (3) tuple of values as args\n    &gt;&gt;&gt; t.add_rows(*(4, 1, 2, 3))                           # (4) unpacked tuple becomes arg like (1)\n    &gt;&gt;&gt; t.add_rows(row=5, A=1, B=2, C=3)                    # (5) kwargs\n    &gt;&gt;&gt; t.add_rows(**{'row': 6, 'A': 1, 'B': 2, 'C': 3})    # (6) dict / json interpreted a kwargs\n    &gt;&gt;&gt; t.add_rows((7, 1, 2, 3), (8, 4, 5, 6))              # (7) two (or more) tuples as args\n    &gt;&gt;&gt; t.add_rows([9, 1, 2, 3], [10, 4, 5, 6])             # (8) two or more lists as rgs\n    &gt;&gt;&gt; t.add_rows(\n        {'row': 11, 'A': 1, 'B': 2, 'C': 3},\n        {'row': 12, 'A': 4, 'B': 5, 'C': 6}\n        )                                                   # (9) two (or more) dicts as args - roughly comma sep'd json.\n    &gt;&gt;&gt; t.add_rows( *[\n        {'row': 13, 'A': 1, 'B': 2, 'C': 3},\n        {'row': 14, 'A': 1, 'B': 2, 'C': 3}\n        ])                                                  # (10) list of dicts as args\n    &gt;&gt;&gt; t.add_rows(row=[15,16], A=[1,1], B=[2,2], C=[3,3])  # (11) kwargs with lists as values\n    ```\n\n    \"\"\"\n    if not BaseTable._add_row_slow_warning:\n        warnings.warn(\n            \"add_rows is slow. Consider using add_columns and then assigning values to the columns directly.\"\n        )\n        BaseTable._add_row_slow_warning = True\n\n    if args:\n        if not all(isinstance(i, (list, tuple, dict)) for i in args):  # 1,4\n            args = [args]\n\n        if all(isinstance(i, (list, tuple, dict)) for i in args):  # 2,3,7,8\n            # 1. turn the data into columns:\n\n            d = {n: [] for n in self.columns}\n            for arg in args:\n                if len(arg) != len(self.columns):\n                    raise ValueError(\n                        f\"len({arg})== {len(arg)}, but there are {len(self.columns)} columns\"\n                    )\n\n                if isinstance(arg, dict):\n                    for k, v in arg.items():  # 7,8\n                        d[k].append(v)\n\n                elif isinstance(arg, (list, tuple)):  # 2,3\n                    for n, v in zip(self.columns, arg):\n                        d[n].append(v)\n\n                else:\n                    raise TypeError(f\"{arg}?\")\n            # 2. extend the columns\n            for n, values in d.items():\n                col = self.columns[n]\n                col.extend(list_to_np_array(values))\n\n    if kwargs:\n        if isinstance(kwargs, dict):\n            if all(isinstance(v, (list, tuple)) for v in kwargs.values()):\n                for k, v in kwargs.items():\n                    col = self.columns[k]\n                    col.extend(list_to_np_array(v))\n            else:\n                for k, v in kwargs.items():\n                    col = self.columns[k]\n                    col.extend(np.array([v]))\n        else:\n            raise ValueError(f\"format not recognised: {kwargs}\")\n\n    return\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.add_columns","title":"<code>tablite.core.Table.add_columns(*names)</code>","text":"<p>Adds column names to table.</p> Source code in <code>tablite/base.py</code> <pre><code>def add_columns(self, *names):\n    \"\"\"Adds column names to table.\"\"\"\n    for name in names:\n        self.columns[name] = Column(self.path)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.add_column","title":"<code>tablite.core.Table.add_column(name, data=None)</code>","text":"<p>verbose alias for table[name] = data, that checks if name already exists</p> PARAMETER  DESCRIPTION <code>name</code> <p>column name</p> <p> TYPE: <code>str</code> </p> <code>data</code> <p>values. Defaults to None.</p> <p> TYPE: <code>list,tuple)</code> DEFAULT: <code>None</code> </p> RAISES DESCRIPTION <code>TypeError</code> <p>name isn't string</p> <code>ValueError</code> <p>name already exists</p> Source code in <code>tablite/base.py</code> <pre><code>def add_column(self, name, data=None):\n    \"\"\"verbose alias for table[name] = data, that checks if name already exists\n\n    Args:\n        name (str): column name\n        data ((list,tuple), optional): values. Defaults to None.\n\n    Raises:\n        TypeError: name isn't string\n        ValueError: name already exists\n    \"\"\"\n    if not isinstance(name, str):\n        raise TypeError(\"expected name as string\")\n    if name in self.columns:\n        raise ValueError(f\"{name} already in {self.columns}\")\n    self.__setitem__(name, data)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.stack","title":"<code>tablite.core.Table.stack(other)</code>","text":"<p>returns the joint stack of tables with overlapping column names. Example:</p> <pre><code>| Table A|  +  | Table B| = |  Table AB |\n| A| B| C|     | A| B| D|   | A| B| C| -|\n                            | A| B| -| D|\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def stack(self, other):\n    \"\"\"\n    returns the joint stack of tables with overlapping column names.\n    Example:\n    ```\n    | Table A|  +  | Table B| = |  Table AB |\n    | A| B| C|     | A| B| D|   | A| B| C| -|\n                                | A| B| -| D|\n    ```\n    \"\"\"\n    if not isinstance(other, BaseTable):\n        raise TypeError(f\"stack only works for Table, not {type(other)}\")\n\n    cp = self.copy()\n    for name, col2 in other.columns.items():\n        if name not in cp.columns:\n            cp[name] = [None] * len(self)\n        cp[name].pages.extend(col2.pages[:])\n\n    for name in self.columns:\n        if name not in other.columns:\n            if len(cp) &gt; 0:\n                cp[name].extend(np.array([None] * len(other)))\n    return cp\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.types","title":"<code>tablite.core.Table.types()</code>","text":"<p>returns nested dict of data types in the form: <code>{column name: {python type class: number of instances }, ... }</code></p> <p>example:</p> <pre><code>&gt;&gt;&gt; t.types()\n{\n    'A': {&lt;class 'str'&gt;: 7},\n    'B': {&lt;class 'int'&gt;: 7}\n}\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def types(self):\n    \"\"\"\n    returns nested dict of data types in the form:\n    `{column name: {python type class: number of instances }, ... }`\n\n    example:\n    ```\n    &gt;&gt;&gt; t.types()\n    {\n        'A': {&lt;class 'str'&gt;: 7},\n        'B': {&lt;class 'int'&gt;: 7}\n    }\n    ```\n    \"\"\"\n    d = {}\n    for name, col in self.columns.items():\n        assert isinstance(col, Column)\n        d[name] = col.types()\n    return d\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.display_dict","title":"<code>tablite.core.Table.display_dict(slice_=None, blanks=None, dtype=False)</code>","text":"<p>helper for creating dict for display.</p> PARAMETER  DESCRIPTION <code>slice_</code> <p>python slice. Defaults to None.</p> <p> TYPE: <code>slice</code> DEFAULT: <code>None</code> </p> <code>blanks</code> <p>fill value for <code>None</code>. Defaults to None.</p> <p> TYPE: <code>optional</code> DEFAULT: <code>None</code> </p> <code>dtype</code> <p>Adds datatype to each column. Defaults to False.</p> <p> TYPE: <code>bool</code> DEFAULT: <code>False</code> </p> RAISES DESCRIPTION <code>TypeError</code> <p>slice_ must be None or slice.</p> RETURNS DESCRIPTION <code>dict</code> <p>from Table.</p> Source code in <code>tablite/base.py</code> <pre><code>def display_dict(self, slice_=None, blanks=None, dtype=False):\n    \"\"\"helper for creating dict for display.\n\n    Args:\n        slice_ (slice, optional): python slice. Defaults to None.\n        blanks (optional): fill value for `None`. Defaults to None.\n        dtype (bool, optional): Adds datatype to each column. Defaults to False.\n\n    Raises:\n        TypeError: slice_ must be None or slice.\n\n    Returns:\n        dict: from Table.\n    \"\"\"\n    if not self.columns:\n        print(\"Empty Table\")\n        return\n\n    def datatype(col):  # PRIVATE\n        \"\"\"creates label for column datatype.\"\"\"\n        types = col.types()\n        if len(types) == 0:\n            typ = \"empty\"\n        elif len(types) == 1:\n            dt, _ = types.popitem()\n            typ = dt.__name__\n        else:\n            typ = \"mixed\"\n        return typ\n\n    row_count_tags = [\"#\", \"~\", \"*\"]\n    cols = set(self.columns)\n    for n, tag in product(range(1, 6), row_count_tags):\n        if n * tag not in cols:\n            tag = n * tag\n            break\n\n    if not isinstance(slice_, (slice, type(None))):\n        raise TypeError(f\"slice_ must be None or slice, not {type(slice_)}\")\n    if isinstance(slice_, slice):\n        slc = slice_\n    if slice_ is None:\n        if len(self) &lt;= 20:\n            slc = slice(0, 20, 1)\n        else:\n            slc = None\n\n    n = len(self)\n    if slc:  # either we want slc or we want everything.\n        row_no = list(range(*slc.indices(len(self))))\n        data = {tag: [f\"{i:,}\".rjust(2) for i in row_no]}\n        for name, col in self.columns.items():\n            data[name] = list(chain(iter(col), repeat(blanks, times=n - len(col))))[\n                slc\n            ]\n    else:\n        data = {}\n        j = int(math.ceil(math.log10(n)) / 3) + len(str(n))\n        row_no = (\n            [f\"{i:,}\".rjust(j) for i in range(7)]\n            + [\"...\"]\n            + [f\"{i:,}\".rjust(j) for i in range(n - 7, n)]\n        )\n        data = {tag: row_no}\n\n        for name, col in self.columns.items():\n            if len(col) == n:\n                row = col[:7].tolist() + [\"...\"] + col[-7:].tolist()\n            else:\n                empty = [blanks] * 7\n                head = (col[:7].tolist() + empty)[:7]\n                tail = (col[n - 7 :].tolist() + empty)[-7:]\n                row = head + [\"...\"] + tail\n            data[name] = row\n\n    if dtype:\n        for name, values in data.items():\n            if name in self.columns:\n                col = self.columns[name]\n                values.insert(0, datatype(col))\n            else:\n                values.insert(0, \"row\")\n\n    return data\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_ascii","title":"<code>tablite.core.Table.to_ascii(slice_=None, blanks=None, dtype=False)</code>","text":"<p>returns ascii view of table as string.</p> PARAMETER  DESCRIPTION <code>slice_</code> <p>slice to determine table snippet.</p> <p> TYPE: <code>slice</code> DEFAULT: <code>None</code> </p> <code>blanks</code> <p>value for whitespace. Defaults to None.</p> <p> TYPE: <code>str</code> DEFAULT: <code>None</code> </p> <code>dtype</code> <p>adds subheader with datatype for column. Defaults to False.</p> <p> TYPE: <code>bool</code> DEFAULT: <code>False</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def to_ascii(self, slice_=None, blanks=None, dtype=False):\n    \"\"\"returns ascii view of table as string.\n\n    Args:\n        slice_ (slice, optional): slice to determine table snippet.\n        blanks (str, optional): value for whitespace. Defaults to None.\n        dtype (bool, optional): adds subheader with datatype for column. Defaults to False.\n    \"\"\"\n\n    def adjust(v, length):  # PRIVATE FUNCTION\n        \"\"\"whitespace justifies field values based on datatype\"\"\"\n        if v is None:\n            return str(blanks).ljust(length)\n        elif isinstance(v, str):\n            return v.ljust(length)\n        else:\n            return str(v).rjust(length)\n\n    if not self.columns:\n        return str(self)\n\n    d = {}\n    for name, values in self.display_dict(\n        slice_=slice_, blanks=blanks, dtype=dtype\n    ).items():\n        as_text = [str(v) for v in values] + [str(name)]\n        width = max(len(i) for i in as_text)\n        new_name = name.center(width, \" \")\n        if dtype:\n            values[0] = values[0].center(width, \" \")\n        d[new_name] = [adjust(v, width) for v in values]\n\n    rows = dict_to_rows(d)\n    s = []\n    s.append(\"+\" + \"+\".join([\"=\" * len(n) for n in rows[0]]) + \"+\")\n    s.append(\"|\" + \"|\".join(rows[0]) + \"|\")  # column names\n    start = 1\n    if dtype:\n        s.append(\"|\" + \"|\".join(rows[1]) + \"|\")  # datatypes\n        start = 2\n\n    s.append(\"+\" + \"+\".join([\"-\" * len(n) for n in rows[0]]) + \"+\")\n    for row in rows[start:]:\n        s.append(\"|\" + \"|\".join(row) + \"|\")\n    s.append(\"+\" + \"+\".join([\"=\" * len(n) for n in rows[0]]) + \"+\")\n\n    if len(set(len(c) for c in self.columns.values())) != 1:\n        warning = f\"Warning: Columns have different lengths. {blanks} is used as fill value.\"\n        s.append(warning)\n\n    return \"\\n\".join(s)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.show","title":"<code>tablite.core.Table.show(slice_=None, blanks=None, dtype=False)</code>","text":"<p>prints ascii view of table.</p> PARAMETER  DESCRIPTION <code>slice_</code> <p>slice to determine table snippet.</p> <p> TYPE: <code>slice</code> DEFAULT: <code>None</code> </p> <code>blanks</code> <p>value for whitespace. Defaults to None.</p> <p> TYPE: <code>str</code> DEFAULT: <code>None</code> </p> <code>dtype</code> <p>adds subheader with datatype for column. Defaults to False.</p> <p> TYPE: <code>bool</code> DEFAULT: <code>False</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def show(self, slice_=None, blanks=None, dtype=False):\n    \"\"\"prints ascii view of table.\n\n    Args:\n        slice_ (slice, optional): slice to determine table snippet.\n        blanks (str, optional): value for whitespace. Defaults to None.\n        dtype (bool, optional): adds subheader with datatype for column. Defaults to False.\n    \"\"\"\n    print(self.to_ascii(slice_=slice_, blanks=blanks, dtype=dtype))\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_dict","title":"<code>tablite.core.Table.to_dict(columns=None, slice_=None)</code>","text":"<p>columns: list of column names. Default is None == all columns. slice_: slice. Default is None == all rows.</p> <p>returns: dict with columns as keys and lists of values.</p> <p>Example:</p> <pre><code>&gt;&gt;&gt; t.show()\n+===+===+===+\n| # | a | b |\n|row|int|int|\n+---+---+---+\n| 0 |  1|  3|\n| 1 |  2|  4|\n+===+===+===+\n&gt;&gt;&gt; t.to_dict()\n{'a':[1,2], 'b':[3,4]}\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def to_dict(self, columns=None, slice_=None):\n    \"\"\"\n    columns: list of column names. Default is None == all columns.\n    slice_: slice. Default is None == all rows.\n\n    returns: dict with columns as keys and lists of values.\n\n    Example:\n    ```\n    &gt;&gt;&gt; t.show()\n    +===+===+===+\n    | # | a | b |\n    |row|int|int|\n    +---+---+---+\n    | 0 |  1|  3|\n    | 1 |  2|  4|\n    +===+===+===+\n    &gt;&gt;&gt; t.to_dict()\n    {'a':[1,2], 'b':[3,4]}\n    ```\n\n    \"\"\"\n    if slice_ is None:\n        slice_ = slice(0, len(self))\n    assert isinstance(slice_, slice)\n\n    if columns is None:\n        columns = list(self.columns.keys())\n    if not isinstance(columns, list):\n        raise TypeError(\"expected columns as list of strings\")\n\n    return {name: list(self.columns[name][slice_]) for name in columns}\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.as_json_serializable","title":"<code>tablite.core.Table.as_json_serializable(row_count='row id', start_on=1, columns=None, slice_=None)</code>","text":"<p>provides a JSON compatible format of the table.</p> PARAMETER  DESCRIPTION <code>row_count</code> <p>Label for row counts. Defaults to \"row id\".</p> <p> TYPE: <code>str</code> DEFAULT: <code>'row id'</code> </p> <code>start_on</code> <p>row counts starts by default on 1.</p> <p> TYPE: <code>int</code> DEFAULT: <code>1</code> </p> <code>columns</code> <p>Column names. Defaults to None which returns all columns.</p> <p> TYPE: <code>list of str</code> DEFAULT: <code>None</code> </p> <code>slice_</code> <p>selector. Defaults to None which returns [:]</p> <p> TYPE: <code>slice</code> DEFAULT: <code>None</code> </p> RETURNS DESCRIPTION <p>JSON serializable dict: All python datatypes have been converted to JSON compliant data.</p> Source code in <code>tablite/base.py</code> <pre><code>def as_json_serializable(\n    self, row_count=\"row id\", start_on=1, columns=None, slice_=None\n):\n    \"\"\"provides a JSON compatible format of the table.\n\n    Args:\n        row_count (str, optional): Label for row counts. Defaults to \"row id\".\n        start_on (int, optional): row counts starts by default on 1.\n        columns (list of str, optional): Column names.\n            Defaults to None which returns all columns.\n        slice_ (slice, optional): selector. Defaults to None which returns [:]\n\n    Returns:\n        JSON serializable dict: All python datatypes have been converted to JSON compliant data.\n    \"\"\"\n    if slice_ is None:\n        slice_ = slice(0, len(self))\n\n    assert isinstance(slice_, slice)\n    new = {\"columns\": {}, \"total_rows\": len(self)}\n    if row_count is not None:\n        new[\"columns\"][row_count] = [\n            i + start_on for i in range(*slice_.indices(len(self)))\n        ]\n\n    d = self.to_dict(columns, slice_=slice_)\n    for k, data in d.items():\n        new_k = unique_name(\n            k, new[\"columns\"]\n        )  # used to avoid overwriting the `row id` key.\n        new[\"columns\"][new_k] = [\n            DataTypes.to_json(v) for v in data\n        ]  # deal with non-json datatypes.\n    return new\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.index","title":"<code>tablite.core.Table.index(*args)</code>","text":"<p>param: *args: column names returns multikey index on the columns as d[(key tuple, )] = {index1, index2, ...}</p> <p>Examples:</p> <pre><code>&gt;&gt;&gt; table6 = Table()\n&gt;&gt;&gt; table6['A'] = ['Alice', 'Bob', 'Bob', 'Ben', 'Charlie', 'Ben','Albert']\n&gt;&gt;&gt; table6['B'] = ['Alison', 'Marley', 'Dylan', 'Affleck', 'Hepburn', 'Barnes', 'Einstein']\n</code></pre> <pre><code>&gt;&gt;&gt; table6.index('A')  # single key.\n{('Alice',): [0],\n ('Bob',): [1, 2],\n ('Ben',): [3, 5],\n ('Charlie',): [4],\n ('Albert',): [6]})\n</code></pre> <pre><code>&gt;&gt;&gt; table6.index('A', 'B')  # multiple keys.\n{('Alice', 'Alison'): [0],\n ('Bob', 'Marley'): [1],\n ('Bob', 'Dylan'): [2],\n ('Ben', 'Affleck'): [3],\n ('Charlie', 'Hepburn'): [4],\n ('Ben', 'Barnes'): [5],\n ('Albert', 'Einstein'): [6]})\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def index(self, *args):\n    \"\"\"\n    param: *args: column names\n    returns multikey index on the columns as d[(key tuple, )] = {index1, index2, ...}\n\n    Examples:\n        ```\n        &gt;&gt;&gt; table6 = Table()\n        &gt;&gt;&gt; table6['A'] = ['Alice', 'Bob', 'Bob', 'Ben', 'Charlie', 'Ben','Albert']\n        &gt;&gt;&gt; table6['B'] = ['Alison', 'Marley', 'Dylan', 'Affleck', 'Hepburn', 'Barnes', 'Einstein']\n        ```\n\n        ```\n        &gt;&gt;&gt; table6.index('A')  # single key.\n        {('Alice',): [0],\n         ('Bob',): [1, 2],\n         ('Ben',): [3, 5],\n         ('Charlie',): [4],\n         ('Albert',): [6]})\n        ```\n\n        ```\n        &gt;&gt;&gt; table6.index('A', 'B')  # multiple keys.\n        {('Alice', 'Alison'): [0],\n         ('Bob', 'Marley'): [1],\n         ('Bob', 'Dylan'): [2],\n         ('Ben', 'Affleck'): [3],\n         ('Charlie', 'Hepburn'): [4],\n         ('Ben', 'Barnes'): [5],\n         ('Albert', 'Einstein'): [6]})\n        ```\n\n    \"\"\"\n    idx = defaultdict(list)\n    iterators = [iter(self.columns[c]) for c in args]\n    for ix, key in enumerate(zip(*iterators)):\n        key = tuple(numpy_to_python(k) for k in key)\n        idx[key].append(ix)\n    return idx\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.unique_index","title":"<code>tablite.core.Table.unique_index(*args, tqdm=_tqdm)</code>","text":"<p>generates the index of unique rows given a list of column names</p> PARAMETER  DESCRIPTION <code>*args</code> <p>columns names</p> <p> TYPE: <code>any</code> DEFAULT: <code>()</code> </p> <code>tqdm</code> <p>Defaults to _tqdm.</p> <p> TYPE: <code>tqdm</code> DEFAULT: <code>tqdm</code> </p> RETURNS DESCRIPTION <p>np.array(int64): indices of unique records.</p> Source code in <code>tablite/base.py</code> <pre><code>def unique_index(self, *args, tqdm=_tqdm):\n    \"\"\"generates the index of unique rows given a list of column names\n\n    Args:\n        *args (any): columns names\n        tqdm (tqdm, optional): Defaults to _tqdm.\n\n    Returns:\n        np.array(int64): indices of unique records.\n    \"\"\"\n    if not args:\n        raise ValueError(\"*args (column names) is required\")\n    seen = set()\n    unique = set()\n    iterators = [iter(self.columns[c]) for c in args]\n    for ix, key in tqdm(enumerate(zip(*iterators)), disable=Config.TQDM_DISABLE):\n        key_hash = hash(tuple(numpy_to_python(k) for k in key))\n        if key_hash in seen:\n            continue\n        else:\n            seen.add(key_hash)\n            unique.add(ix)\n    return np.array(sorted(unique))\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.from_file","title":"<code>tablite.core.Table.from_file(path, columns=None, first_row_has_headers=True, header_row_index=0, encoding=None, start=0, limit=sys.maxsize, sheet=None, guess_datatypes=True, newline='\\n', text_qualifier=None, delimiter=None, strip_leading_and_tailing_whitespace=True, text_escape_openings='', text_escape_closures='', skip_empty: ValidSkipEmpty = 'NONE', tqdm=_tqdm) -&gt; Table</code>  <code>classmethod</code>","text":"<pre><code>    reads path and imports 1 or more tables\n\n    REQUIRED\n    --------\n    path: pathlib.Path or str\n        selection of filereader uses path.suffix.\n        See `filereaders`.\n\n    OPTIONAL\n    --------\n    columns:\n        None: (default) All columns will be imported.\n        List: only column names from list will be imported (if present in file)\n              e.g. ['A', 'B', 'C', 'D']\n\n              datatype is detected using Datatypes.guess(...)\n              You can try it out with:\n              &gt;&gt; from tablite.datatypes import DataTypes\n              &gt;&gt; DataTypes.guess(['001','100'])\n              [1,100]\n\n              if the format cannot be achieved the read type is kept.\n        Excess column names are ignored.\n\n        HINT: To get the head of file use:\n        &gt;&gt;&gt; from tablite.tools import head\n        &gt;&gt;&gt; head = head(path)\n\n    first_row_has_headers: boolean\n        True: (default) first row is used as column names.\n        False: integers are used as column names.\n\n    encoding: str. Defaults to None (autodetect using n bytes).\n        n is declared in filereader_utils as ENCODING_GUESS_BYTES\n\n    start: the first line to be read (default: 0)\n\n    limit: the number of lines to be read from start (default sys.maxint ~ 2**63)\n\n    OPTIONAL FOR EXCEL AND ODS READERS\n    ----------------------------------\n\n    sheet: sheet name to import  (applicable to excel- and ods-reader only)\n        e.g. 'sheet_1'\n        sheets not found excess names are ignored.\n\n    OPTIONAL FOR TEXT READERS\n    -------------------------\n    guess_datatype: bool\n        True: (default) datatypes are guessed using DataTypes.guess(...)\n        False: all data is imported as strings.\n\n    newline: newline character (applicable to text_reader only)\n        str: '\n</code></pre> <p>' (default) or ' '</p> <pre><code>    text_qualifier: character (applicable to text_reader only)\n        None: No text qualifier is used.\n        str: \" or '\n\n    delimiter: character (applicable to text_reader only)\n        None: file suffix is used to determine field delimiter:\n            .txt: \"|\"\n            .csv: \",\",\n            .ssv: \";\"\n            .tsv: \" \" (tab)\n\n    strip_leading_and_tailing_whitespace: bool:\n        True: default\n\n    text_escape_openings: (applicable to text_reader only)\n        None: default\n        str: list of characters such as ([{\n\n    text_escape_closures: (applicable to text_reader only)\n        None: default\n        str: list of characters such as }])\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>@classmethod\ndef from_file(\n    cls,\n    path,\n    columns=None,\n    first_row_has_headers=True,\n    header_row_index=0,\n    encoding=None,\n    start=0,\n    limit=sys.maxsize,\n    sheet=None,\n    guess_datatypes=True,\n    newline=\"\\n\",\n    text_qualifier=None,\n    delimiter=None,\n    strip_leading_and_tailing_whitespace=True,\n    text_escape_openings=\"\",\n    text_escape_closures=\"\",\n    skip_empty: ValidSkipEmpty=\"NONE\",\n    tqdm=_tqdm,\n) -&gt; \"Table\":\n    \"\"\"\n    reads path and imports 1 or more tables\n\n    REQUIRED\n    --------\n    path: pathlib.Path or str\n        selection of filereader uses path.suffix.\n        See `filereaders`.\n\n    OPTIONAL\n    --------\n    columns:\n        None: (default) All columns will be imported.\n        List: only column names from list will be imported (if present in file)\n              e.g. ['A', 'B', 'C', 'D']\n\n              datatype is detected using Datatypes.guess(...)\n              You can try it out with:\n              &gt;&gt; from tablite.datatypes import DataTypes\n              &gt;&gt; DataTypes.guess(['001','100'])\n              [1,100]\n\n              if the format cannot be achieved the read type is kept.\n        Excess column names are ignored.\n\n        HINT: To get the head of file use:\n        &gt;&gt;&gt; from tablite.tools import head\n        &gt;&gt;&gt; head = head(path)\n\n    first_row_has_headers: boolean\n        True: (default) first row is used as column names.\n        False: integers are used as column names.\n\n    encoding: str. Defaults to None (autodetect using n bytes).\n        n is declared in filereader_utils as ENCODING_GUESS_BYTES\n\n    start: the first line to be read (default: 0)\n\n    limit: the number of lines to be read from start (default sys.maxint ~ 2**63)\n\n    OPTIONAL FOR EXCEL AND ODS READERS\n    ----------------------------------\n\n    sheet: sheet name to import  (applicable to excel- and ods-reader only)\n        e.g. 'sheet_1'\n        sheets not found excess names are ignored.\n\n    OPTIONAL FOR TEXT READERS\n    -------------------------\n    guess_datatype: bool\n        True: (default) datatypes are guessed using DataTypes.guess(...)\n        False: all data is imported as strings.\n\n    newline: newline character (applicable to text_reader only)\n        str: '\\n' (default) or '\\r\\n'\n\n    text_qualifier: character (applicable to text_reader only)\n        None: No text qualifier is used.\n        str: \" or '\n\n    delimiter: character (applicable to text_reader only)\n        None: file suffix is used to determine field delimiter:\n            .txt: \"|\"\n            .csv: \",\",\n            .ssv: \";\"\n            .tsv: \"\\t\" (tab)\n\n    strip_leading_and_tailing_whitespace: bool:\n        True: default\n\n    text_escape_openings: (applicable to text_reader only)\n        None: default\n        str: list of characters such as ([{\n\n    text_escape_closures: (applicable to text_reader only)\n        None: default\n        str: list of characters such as }])\n\n    \"\"\"\n    if isinstance(path, str):\n        path = Path(path)\n    type_check(path, Path)\n\n    if not path.exists():\n        raise FileNotFoundError(f\"file not found: {path}\")\n\n    if not isinstance(start, int) or not 0 &lt;= start &lt;= sys.maxsize:\n        raise ValueError(f\"start {start} not in range(0,{sys.maxsize})\")\n\n    if not isinstance(limit, int) or not 0 &lt; limit &lt;= sys.maxsize:\n        raise ValueError(f\"limit {limit} not in range(0,{sys.maxsize})\")\n\n    if not isinstance(first_row_has_headers, bool):\n        raise TypeError(\"first_row_has_headers is not bool\")\n\n    import_as = path.suffix\n    if import_as.startswith(\".\"):\n        import_as = import_as[1:]\n\n    reader = import_utils.file_readers.get(import_as, None)\n    if reader is None:\n        raise ValueError(f\"{import_as} is not in supported format: {import_utils.valid_readers}\")\n\n    additional_configs = {\"tqdm\": tqdm}\n    if reader == import_utils.text_reader:\n        # here we inject tqdm, if tqdm is not provided, use generic iterator\n        # fmt:off\n        config = (path, columns, first_row_has_headers, header_row_index, encoding, start, limit, newline,\n                  guess_datatypes, text_qualifier, strip_leading_and_tailing_whitespace, skip_empty,\n                  delimiter, text_escape_openings, text_escape_closures)\n        # fmt:on\n\n    elif reader == import_utils.from_html:\n        config = (path,)\n    elif reader == import_utils.from_hdf5:\n        config = (path,)\n\n    elif reader == import_utils.excel_reader:\n        # config = path, first_row_has_headers, sheet, columns, start, limit\n        config = (\n            path,\n            first_row_has_headers,\n            header_row_index,\n            sheet,\n            columns,\n            skip_empty,\n            start,\n            limit,\n        )  # if file length changes - re-import.\n\n    if reader == import_utils.ods_reader:\n        # path, first_row_has_headers=True, sheet=None, columns=None, start=0, limit=sys.maxsize,\n        config = (\n            str(path),\n            first_row_has_headers,\n            header_row_index,\n            sheet,\n            columns,\n            skip_empty,\n            start,\n            limit,\n        )  # if file length changes - re-import.\n\n    # At this point the import config seems valid.\n    # Now we check if the file already has been imported.\n\n    # publish the settings\n    return reader(cls, *config, **additional_configs)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.from_pandas","title":"<code>tablite.core.Table.from_pandas(df)</code>  <code>classmethod</code>","text":"<p>Creates Table using pd.to_dict('list')</p> <p>similar to:</p> <pre><code>&gt;&gt;&gt; import pandas as pd\n&gt;&gt;&gt; df = pd.DataFrame({'a':[1,2,3], 'b':[4,5,6]})\n&gt;&gt;&gt; df\n    a  b\n    0  1  4\n    1  2  5\n    2  3  6\n&gt;&gt;&gt; df.to_dict('list')\n{'a': [1, 2, 3], 'b': [4, 5, 6]}\n&gt;&gt;&gt; t = Table.from_dict(df.to_dict('list))\n&gt;&gt;&gt; t.show()\n    +===+===+===+\n    | # | a | b |\n    |row|int|int|\n    +---+---+---+\n    | 0 |  1|  4|\n    | 1 |  2|  5|\n    | 2 |  3|  6|\n    +===+===+===+\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>@classmethod\ndef from_pandas(cls, df):\n    \"\"\"\n    Creates Table using pd.to_dict('list')\n\n    similar to:\n    ```\n    &gt;&gt;&gt; import pandas as pd\n    &gt;&gt;&gt; df = pd.DataFrame({'a':[1,2,3], 'b':[4,5,6]})\n    &gt;&gt;&gt; df\n        a  b\n        0  1  4\n        1  2  5\n        2  3  6\n    &gt;&gt;&gt; df.to_dict('list')\n    {'a': [1, 2, 3], 'b': [4, 5, 6]}\n    &gt;&gt;&gt; t = Table.from_dict(df.to_dict('list))\n    &gt;&gt;&gt; t.show()\n        +===+===+===+\n        | # | a | b |\n        |row|int|int|\n        +---+---+---+\n        | 0 |  1|  4|\n        | 1 |  2|  5|\n        | 2 |  3|  6|\n        +===+===+===+\n    ```\n    \"\"\"\n    return import_utils.from_pandas(cls, df)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.from_hdf5","title":"<code>tablite.core.Table.from_hdf5(path)</code>  <code>classmethod</code>","text":"<p>imports an exported hdf5 table.</p> Source code in <code>tablite/core.py</code> <pre><code>@classmethod\ndef from_hdf5(cls, path):\n    \"\"\"\n    imports an exported hdf5 table.\n    \"\"\"\n    return import_utils.from_hdf5(cls, path)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.from_json","title":"<code>tablite.core.Table.from_json(jsn)</code>  <code>classmethod</code>","text":"<p>Imports table exported using .to_json</p> Source code in <code>tablite/core.py</code> <pre><code>@classmethod\ndef from_json(cls, jsn):\n    \"\"\"\n    Imports table exported using .to_json\n    \"\"\"\n    return import_utils.from_json(cls, jsn)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_hdf5","title":"<code>tablite.core.Table.to_hdf5(path)</code>","text":"<p>creates a copy of the table as hdf5</p> Source code in <code>tablite/core.py</code> <pre><code>def to_hdf5(self, path):\n    \"\"\"\n    creates a copy of the table as hdf5\n    \"\"\"\n    export_utils.to_hdf5(self, path)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_pandas","title":"<code>tablite.core.Table.to_pandas()</code>","text":"<p>returns pandas.DataFrame</p> Source code in <code>tablite/core.py</code> <pre><code>def to_pandas(self):\n    \"\"\"\n    returns pandas.DataFrame\n    \"\"\"\n    return export_utils.to_pandas(self)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_sql","title":"<code>tablite.core.Table.to_sql(name)</code>","text":"<p>generates ANSI-92 compliant SQL.</p> Source code in <code>tablite/core.py</code> <pre><code>def to_sql(self, name):\n    \"\"\"\n    generates ANSI-92 compliant SQL.\n    \"\"\"\n    return export_utils.to_sql(self, name)  # remove after update to test suite.\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_json","title":"<code>tablite.core.Table.to_json()</code>","text":"<p>returns JSON</p> Source code in <code>tablite/core.py</code> <pre><code>def to_json(self):\n    \"\"\"\n    returns JSON\n    \"\"\"\n    return export_utils.to_json(self)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_xlsx","title":"<code>tablite.core.Table.to_xlsx(path)</code>","text":"<p>exports table to path</p> Source code in <code>tablite/core.py</code> <pre><code>def to_xlsx(self, path):\n    \"\"\"\n    exports table to path\n    \"\"\"\n    export_utils.path_suffix_check(path, \".xlsx\")\n    export_utils.excel_writer(self, path)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_ods","title":"<code>tablite.core.Table.to_ods(path)</code>","text":"<p>exports table to path</p> Source code in <code>tablite/core.py</code> <pre><code>def to_ods(self, path):\n    \"\"\"\n    exports table to path\n    \"\"\"\n    export_utils.path_suffix_check(path, \".ods\")\n    export_utils.excel_writer(self, path)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_csv","title":"<code>tablite.core.Table.to_csv(path)</code>","text":"<p>exports table to path</p> Source code in <code>tablite/core.py</code> <pre><code>def to_csv(self, path):\n    \"\"\"\n    exports table to path\n    \"\"\"\n    export_utils.path_suffix_check(path, \".csv\")\n    export_utils.text_writer(self, path)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_tsv","title":"<code>tablite.core.Table.to_tsv(path)</code>","text":"<p>exports table to path</p> Source code in <code>tablite/core.py</code> <pre><code>def to_tsv(self, path):\n    \"\"\"\n    exports table to path\n    \"\"\"\n    export_utils.path_suffix_check(path, \".tsv\")\n    export_utils.text_writer(self, path)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_text","title":"<code>tablite.core.Table.to_text(path)</code>","text":"<p>exports table to path</p> Source code in <code>tablite/core.py</code> <pre><code>def to_text(self, path):\n    \"\"\"\n    exports table to path\n    \"\"\"\n    export_utils.path_suffix_check(path, \".txt\")\n    export_utils.text_writer(self, path)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_html","title":"<code>tablite.core.Table.to_html(path)</code>","text":"<p>exports table to path</p> Source code in <code>tablite/core.py</code> <pre><code>def to_html(self, path):\n    \"\"\"\n    exports table to path\n    \"\"\"\n    export_utils.path_suffix_check(path, \".html\")\n    export_utils.to_html(self, path)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.expression","title":"<code>tablite.core.Table.expression(expression)</code>","text":"<p>filters based on an expression, such as:</p> <pre><code>\"all((A==B, C!=4, 200&lt;D))\"\n</code></pre> <p>which is interpreted using python's compiler to:</p> <pre><code>def _f(A,B,C,D):\n    return all((A==B, C!=4, 200&lt;D))\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>def expression(self, expression):\n    \"\"\"\n    filters based on an expression, such as:\n\n        \"all((A==B, C!=4, 200&lt;D))\"\n\n    which is interpreted using python's compiler to:\n\n        def _f(A,B,C,D):\n            return all((A==B, C!=4, 200&lt;D))\n    \"\"\"\n    return redux._filter_using_expression(self, expression)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.filter","title":"<code>tablite.core.Table.filter(expressions, filter_type='all', tqdm=_tqdm)</code>","text":"<p>enables filtering across columns for multiple criteria.</p> <p>expressions:</p> <pre><code>str: Expression that can be compiled and executed row by row.\n    exampLe: \"all((A==B and C!=4 and 200&lt;D))\"\n\nlist of dicts: (example):\n\n    L = [\n        {'column1':'A', 'criteria': \"==\", 'column2': 'B'},\n        {'column1':'C', 'criteria': \"!=\", \"value2\": '4'},\n        {'value1': 200, 'criteria': \"&lt;\", column2: 'D' }\n    ]\n\naccepted dictionary keys: 'column1', 'column2', 'criteria', 'value1', 'value2'\n</code></pre> <p>filter_type: 'all' or 'any'</p> Source code in <code>tablite/core.py</code> <pre><code>def filter(self, expressions, filter_type=\"all\", tqdm=_tqdm):\n    \"\"\"\n    enables filtering across columns for multiple criteria.\n\n    expressions:\n\n        str: Expression that can be compiled and executed row by row.\n            exampLe: \"all((A==B and C!=4 and 200&lt;D))\"\n\n        list of dicts: (example):\n\n            L = [\n                {'column1':'A', 'criteria': \"==\", 'column2': 'B'},\n                {'column1':'C', 'criteria': \"!=\", \"value2\": '4'},\n                {'value1': 200, 'criteria': \"&lt;\", column2: 'D' }\n            ]\n\n        accepted dictionary keys: 'column1', 'column2', 'criteria', 'value1', 'value2'\n\n    filter_type: 'all' or 'any'\n    \"\"\"\n    return redux.filter(self, expressions, filter_type, tqdm)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.sort_index","title":"<code>tablite.core.Table.sort_index(sort_mode='excel', tqdm=_tqdm, pbar=None, **kwargs)</code>","text":"<p>helper for methods <code>sort</code> and <code>is_sorted</code></p> <p>param: sort_mode: str: \"alphanumeric\", \"unix\", or, \"excel\" (default) param: **kwargs: sort criteria. See Table.sort()</p> Source code in <code>tablite/core.py</code> <pre><code>def sort_index(self, sort_mode=\"excel\", tqdm=_tqdm, pbar=None, **kwargs):\n    \"\"\"\n    helper for methods `sort` and `is_sorted`\n\n    param: sort_mode: str: \"alphanumeric\", \"unix\", or, \"excel\" (default)\n    param: **kwargs: sort criteria. See Table.sort()\n    \"\"\"\n    return sortation.sort_index(self, sort_mode, tqdm=tqdm, pbar=pbar, **kwargs)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.reindex","title":"<code>tablite.core.Table.reindex(index)</code>","text":"<p>index: list of integers that declare sort order.</p> <p>Examples:</p> <pre><code>Table:  ['a','b','c','d','e','f','g','h']\nindex:  [0,2,4,6]\nresult: ['b','d','f','h']\n\nTable:  ['a','b','c','d','e','f','g','h']\nindex:  [0,2,4,6,1,3,5,7]\nresult: ['a','c','e','g','b','d','f','h']\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>def reindex(self, index):\n    \"\"\"\n    index: list of integers that declare sort order.\n\n    Examples:\n\n        Table:  ['a','b','c','d','e','f','g','h']\n        index:  [0,2,4,6]\n        result: ['b','d','f','h']\n\n        Table:  ['a','b','c','d','e','f','g','h']\n        index:  [0,2,4,6,1,3,5,7]\n        result: ['a','c','e','g','b','d','f','h']\n\n    \"\"\"\n    if isinstance(index, list):\n        index = np.array(index)\n    return _reindex.reindex(self, index)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.drop_duplicates","title":"<code>tablite.core.Table.drop_duplicates(*args)</code>","text":"<p>removes duplicate rows based on column names</p> <p>args: (optional) column_names if no args, all columns are used.</p> Source code in <code>tablite/core.py</code> <pre><code>def drop_duplicates(self, *args):\n    \"\"\"\n    removes duplicate rows based on column names\n\n    args: (optional) column_names\n    if no args, all columns are used.\n    \"\"\"\n    if not args:\n        args = self.columns\n    index = self.unique_index(*args)\n    return self.reindex(index)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.sort","title":"<code>tablite.core.Table.sort(mapping, sort_mode='excel', tqdm=_tqdm, pbar: _tqdm = None)</code>","text":"<p>Perform multi-pass sorting with precedence given order of column names.</p> PARAMETER  DESCRIPTION <code>mapping</code> <p>keys as columns,             values as boolean for 'reverse'</p> <p> TYPE: <code>dict</code> </p> <code>sort_mode</code> <p>str: \"alphanumeric\", \"unix\", or, \"excel\"</p> <p> DEFAULT: <code>'excel'</code> </p> RETURNS DESCRIPTION <code>None</code> <p>Table.sort is sorted inplace</p> <p>Examples: Table.sort(mappinp={A':False}) means sort by 'A' in ascending order. Table.sort(mapping={'A':True, 'B':False}) means sort 'A' in descending order, then (2nd priority) sort B in ascending order.</p> Source code in <code>tablite/core.py</code> <pre><code>def sort(self, mapping, sort_mode=\"excel\", tqdm=_tqdm, pbar: _tqdm = None):\n    \"\"\"Perform multi-pass sorting with precedence given order of column names.\n\n    Args:\n        mapping (dict): keys as columns,\n                        values as boolean for 'reverse'\n        sort_mode: str: \"alphanumeric\", \"unix\", or, \"excel\"\n\n    Returns:\n        None: Table.sort is sorted inplace\n\n    Examples:\n    Table.sort(mappinp={A':False}) means sort by 'A' in ascending order.\n    Table.sort(mapping={'A':True, 'B':False}) means sort 'A' in descending order, then (2nd priority)\n    sort B in ascending order.\n    \"\"\"\n    new = sortation.sort(self, mapping, sort_mode, tqdm=tqdm, pbar=pbar)\n    self.columns = new.columns\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.sorted","title":"<code>tablite.core.Table.sorted(mapping, sort_mode='excel', tqdm=_tqdm, pbar: _tqdm = None)</code>","text":"<p>See sort. Sorted returns a new table in contrast to \"sort\", which is in-place.</p> RETURNS DESCRIPTION <p>Table.</p> Source code in <code>tablite/core.py</code> <pre><code>def sorted(self, mapping, sort_mode=\"excel\", tqdm=_tqdm, pbar: _tqdm = None):\n    \"\"\"See sort.\n    Sorted returns a new table in contrast to \"sort\", which is in-place.\n\n    Returns:\n        Table.\n    \"\"\"\n    return sortation.sort(self, mapping, sort_mode, tqdm=tqdm, pbar=pbar)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.is_sorted","title":"<code>tablite.core.Table.is_sorted(mapping, sort_mode='excel')</code>","text":"<p>Performs multi-pass sorting check with precedence given order of column names. **kwargs: optional: sort criteria. See Table.sort() :return bool</p> Source code in <code>tablite/core.py</code> <pre><code>def is_sorted(self, mapping, sort_mode=\"excel\"):\n    \"\"\"Performs multi-pass sorting check with precedence given order of column names.\n    **kwargs: optional: sort criteria. See Table.sort()\n    :return bool\n    \"\"\"\n    return sortation.is_sorted(self, mapping, sort_mode)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.any","title":"<code>tablite.core.Table.any(**kwargs)</code>","text":"<p>returns Table for rows where ANY kwargs match :param kwargs: dictionary with headers and values / boolean callable</p> Source code in <code>tablite/core.py</code> <pre><code>def any(self, **kwargs):\n    \"\"\"\n    returns Table for rows where ANY kwargs match\n    :param kwargs: dictionary with headers and values / boolean callable\n    \"\"\"\n    return redux.filter_any(self, **kwargs)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.all","title":"<code>tablite.core.Table.all(**kwargs)</code>","text":"<p>returns Table for rows where ALL kwargs match :param kwargs: dictionary with headers and values / boolean callable</p> <p>Examples:</p> <pre><code>t = Table()\nt['a'] = [1,2,3,4]\nt['b'] = [10,20,30,40]\n\ndef f(x):\n    return x == 4\ndef g(x):\n    return x &lt; 20\n\nt2 = t.any( **{\"a\":f, \"b\":g})\nassert [r for r in t2.rows] == [[1, 10], [4, 40]]\n\nt2 = t.any(a=f,b=g)\nassert [r for r in t2.rows] == [[1, 10], [4, 40]]\n\ndef h(x):\n    return x&gt;=2\n\ndef i(x):\n    return x&lt;=30\n\nt2 = t.all(a=h,b=i)\nassert [r for r in t2.rows] == [[2,20], [3, 30]]\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>def all(self, **kwargs):\n    \"\"\"\n    returns Table for rows where ALL kwargs match\n    :param kwargs: dictionary with headers and values / boolean callable\n\n    Examples:\n\n        t = Table()\n        t['a'] = [1,2,3,4]\n        t['b'] = [10,20,30,40]\n\n        def f(x):\n            return x == 4\n        def g(x):\n            return x &lt; 20\n\n        t2 = t.any( **{\"a\":f, \"b\":g})\n        assert [r for r in t2.rows] == [[1, 10], [4, 40]]\n\n        t2 = t.any(a=f,b=g)\n        assert [r for r in t2.rows] == [[1, 10], [4, 40]]\n\n        def h(x):\n            return x&gt;=2\n\n        def i(x):\n            return x&lt;=30\n\n        t2 = t.all(a=h,b=i)\n        assert [r for r in t2.rows] == [[2,20], [3, 30]]\n\n\n    \"\"\"\n    return redux.filter_all(self, **kwargs)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.drop","title":"<code>tablite.core.Table.drop(*args)</code>","text":"<p>removes all rows where args are present.</p> <p>Exmaple:</p> <p>t = Table() t['A'] = [1,2,3,None] t['B'] = [None,2,3,4] t2 = t.drop(None) t2'A', t2'B' ([2,3], [2,3])</p> Source code in <code>tablite/core.py</code> <pre><code>def drop(self, *args):\n    \"\"\"\n    removes all rows where args are present.\n\n    Exmaple:\n    &gt;&gt;&gt; t = Table()\n    &gt;&gt;&gt; t['A'] = [1,2,3,None]\n    &gt;&gt;&gt; t['B'] = [None,2,3,4]\n    &gt;&gt;&gt; t2 = t.drop(None)\n    &gt;&gt;&gt; t2['A'][:], t2['B'][:]\n    ([2,3], [2,3])\n\n    \"\"\"\n    if not args:\n        raise ValueError(\"What to drop? None? np.nan? \")\n    return redux.drop(self, *args)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.replace","title":"<code>tablite.core.Table.replace(mapping, columns=None, tqdm=_tqdm, pbar=None)</code>","text":"<p>replaces all mapped keys with values from named columns</p> PARAMETER  DESCRIPTION <code>mapping</code> <p>keys are targets for replacement,             values are replacements.</p> <p> TYPE: <code>dict</code> </p> <code>columns</code> <p>target columns. Defaults to None (all columns)</p> <p> TYPE: <code>list or str</code> DEFAULT: <code>None</code> </p> RAISES DESCRIPTION <code>ValueError</code> <p>description</p> Source code in <code>tablite/core.py</code> <pre><code>def replace(self, mapping, columns=None, tqdm=_tqdm, pbar=None):\n    \"\"\"replaces all mapped keys with values from named columns\n\n    Args:\n        mapping (dict): keys are targets for replacement,\n                        values are replacements.\n        columns (list or str, optional): target columns.\n            Defaults to None (all columns)\n\n    Raises:\n        ValueError: _description_\n    \"\"\"\n    if columns is None:\n        columns = list(self.columns)\n    if not isinstance(columns, list) and columns in self.columns:\n        columns = [columns]\n    type_check(columns, list)\n    for n in columns:\n        if n not in self.columns:\n            raise ValueError(f\"column not found: {n}\")\n\n    if pbar is None:\n        total = len(columns)\n        pbar = tqdm(total=total, desc=\"replace\", disable=Config.TQDM_DISABLE)\n\n    for name in columns:\n        col = self.columns[name]\n        col.replace(mapping)\n        pbar.update(1)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.groupby","title":"<code>tablite.core.Table.groupby(keys, functions, tqdm=_tqdm, pbar=None)</code>","text":"<p>keys: column names for grouping. functions: [optional] list of column names and group functions (See GroupyBy class) returns: table</p> <p>Example:</p> <pre><code>t = Table()\nt.add_column('A', data=[1, 1, 2, 2, 3, 3] * 2)\nt.add_column('B', data=[1, 2, 3, 4, 5, 6] * 2)\nt.add_column('C', data=[6, 5, 4, 3, 2, 1] * 2)\n\nt.show()\n+=====+=====+=====+\n|  A  |  B  |  C  |\n| int | int | int |\n+-----+-----+-----+\n|    1|    1|    6|\n|    1|    2|    5|\n|    2|    3|    4|\n|    2|    4|    3|\n|    3|    5|    2|\n|    3|    6|    1|\n|    1|    1|    6|\n|    1|    2|    5|\n|    2|    3|    4|\n|    2|    4|    3|\n|    3|    5|    2|\n|    3|    6|    1|\n+=====+=====+=====+\n\ng = t.groupby(keys=['A', 'C'], functions=[('B', gb.sum)])\ng.show()\n+===+===+===+======+\n| # | A | C |Sum(B)|\n|row|int|int| int  |\n+---+---+---+------+\n|0  |  1|  6|     2|\n|1  |  1|  5|     4|\n|2  |  2|  4|     6|\n|3  |  2|  3|     8|\n|4  |  3|  2|    10|\n|5  |  3|  1|    12|\n+===+===+===+======+\n</code></pre> <p>Cheat sheet:</p> <p>list of unique values</p> <pre><code>&gt;&gt;&gt; g1 = t.groupby(keys=['A'], functions=[])\n&gt;&gt;&gt; g1['A'][:]\n[1,2,3]\n</code></pre> <p>alternatively:</p> <p>t['A'].unique() [1,2,3]</p> <p>list of unique values, grouped by longest combination.</p> <pre><code>&gt;&gt;&gt; g2 = t.groupby(keys=['A', 'B'], functions=[])\n&gt;&gt;&gt; g2['A'][:], g2['B'][:]\n([1,1,2,2,3,3], [1,2,3,4,5,6])\n</code></pre> <p>alternatively:</p> <pre><code>&gt;&gt;&gt; list(zip(*t.index('A', 'B').keys()))\n[(1,1,2,2,3,3) (1,2,3,4,5,6)]\n</code></pre> <p>A key (unique values) and count hereof.</p> <pre><code>&gt;&gt;&gt; g3 = t.groupby(keys=['A'], functions=[('A', gb.count)])\n&gt;&gt;&gt; g3['A'][:], g3['Count(A)'][:]\n([1,2,3], [4,4,4])\n</code></pre> <p>alternatively:</p> <pre><code>&gt;&gt;&gt; t['A'].histogram()\n([1,2,3], [4,4,4])\n</code></pre> <p>for more exmaples see:     https://github.com/root-11/tablite/blob/master/tests/test_groupby.py</p> Source code in <code>tablite/core.py</code> <pre><code>def groupby(self, keys, functions, tqdm=_tqdm, pbar=None):\n    \"\"\"\n    keys: column names for grouping.\n    functions: [optional] list of column names and group functions (See GroupyBy class)\n    returns: table\n\n    Example:\n    ```\n    t = Table()\n    t.add_column('A', data=[1, 1, 2, 2, 3, 3] * 2)\n    t.add_column('B', data=[1, 2, 3, 4, 5, 6] * 2)\n    t.add_column('C', data=[6, 5, 4, 3, 2, 1] * 2)\n\n    t.show()\n    +=====+=====+=====+\n    |  A  |  B  |  C  |\n    | int | int | int |\n    +-----+-----+-----+\n    |    1|    1|    6|\n    |    1|    2|    5|\n    |    2|    3|    4|\n    |    2|    4|    3|\n    |    3|    5|    2|\n    |    3|    6|    1|\n    |    1|    1|    6|\n    |    1|    2|    5|\n    |    2|    3|    4|\n    |    2|    4|    3|\n    |    3|    5|    2|\n    |    3|    6|    1|\n    +=====+=====+=====+\n\n    g = t.groupby(keys=['A', 'C'], functions=[('B', gb.sum)])\n    g.show()\n    +===+===+===+======+\n    | # | A | C |Sum(B)|\n    |row|int|int| int  |\n    +---+---+---+------+\n    |0  |  1|  6|     2|\n    |1  |  1|  5|     4|\n    |2  |  2|  4|     6|\n    |3  |  2|  3|     8|\n    |4  |  3|  2|    10|\n    |5  |  3|  1|    12|\n    +===+===+===+======+\n    ```\n    Cheat sheet:\n\n    list of unique values\n    ```\n    &gt;&gt;&gt; g1 = t.groupby(keys=['A'], functions=[])\n    &gt;&gt;&gt; g1['A'][:]\n    [1,2,3]\n    ```\n    alternatively:\n    &gt;&gt;&gt; t['A'].unique()\n    [1,2,3]\n\n    list of unique values, grouped by longest combination.\n    ```\n    &gt;&gt;&gt; g2 = t.groupby(keys=['A', 'B'], functions=[])\n    &gt;&gt;&gt; g2['A'][:], g2['B'][:]\n    ([1,1,2,2,3,3], [1,2,3,4,5,6])\n    ```\n    alternatively:\n    ```\n    &gt;&gt;&gt; list(zip(*t.index('A', 'B').keys()))\n    [(1,1,2,2,3,3) (1,2,3,4,5,6)]\n    ```\n    A key (unique values) and count hereof.\n    ```\n    &gt;&gt;&gt; g3 = t.groupby(keys=['A'], functions=[('A', gb.count)])\n    &gt;&gt;&gt; g3['A'][:], g3['Count(A)'][:]\n    ([1,2,3], [4,4,4])\n    ```\n    alternatively:\n    ```\n    &gt;&gt;&gt; t['A'].histogram()\n    ([1,2,3], [4,4,4])\n    ```\n    for more exmaples see:\n        https://github.com/root-11/tablite/blob/master/tests/test_groupby.py\n\n    \"\"\"\n    return groupbys.groupby(self, keys, functions, tqdm=tqdm, pbar=pbar)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.pivot","title":"<code>tablite.core.Table.pivot(rows, columns, functions, values_as_rows=True, tqdm=_tqdm, pbar=None)</code>","text":"<p>param: rows: column names to keep as rows param: columns: column names to keep as columns param: functions: aggregation functions from the Groupby class as</p> <p>example:</p> <pre><code>t.show()\n+=====+=====+=====+\n|  A  |  B  |  C  |\n| int | int | int |\n+-----+-----+-----+\n|    1|    1|    6|\n|    1|    2|    5|\n|    2|    3|    4|\n|    2|    4|    3|\n|    3|    5|    2|\n|    3|    6|    1|\n|    1|    1|    6|\n|    1|    2|    5|\n|    2|    3|    4|\n|    2|    4|    3|\n|    3|    5|    2|\n|    3|    6|    1|\n+=====+=====+=====+\n\nt2 = t.pivot(rows=['C'], columns=['A'], functions=[('B', gb.sum)])\nt2.show()\n+===+===+========+=====+=====+=====+\n| # | C |function|(A=1)|(A=2)|(A=3)|\n|row|int|  str   |mixed|mixed|mixed|\n+---+---+--------+-----+-----+-----+\n|0  |  6|Sum(B)  |    2|None |None |\n|1  |  5|Sum(B)  |    4|None |None |\n|2  |  4|Sum(B)  |None |    6|None |\n|3  |  3|Sum(B)  |None |    8|None |\n|4  |  2|Sum(B)  |None |None |   10|\n|5  |  1|Sum(B)  |None |None |   12|\n+===+===+========+=====+=====+=====+\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>def pivot(self, rows, columns, functions, values_as_rows=True, tqdm=_tqdm, pbar=None):\n    \"\"\"\n    param: rows: column names to keep as rows\n    param: columns: column names to keep as columns\n    param: functions: aggregation functions from the Groupby class as\n\n    example:\n    ```\n    t.show()\n    +=====+=====+=====+\n    |  A  |  B  |  C  |\n    | int | int | int |\n    +-----+-----+-----+\n    |    1|    1|    6|\n    |    1|    2|    5|\n    |    2|    3|    4|\n    |    2|    4|    3|\n    |    3|    5|    2|\n    |    3|    6|    1|\n    |    1|    1|    6|\n    |    1|    2|    5|\n    |    2|    3|    4|\n    |    2|    4|    3|\n    |    3|    5|    2|\n    |    3|    6|    1|\n    +=====+=====+=====+\n\n    t2 = t.pivot(rows=['C'], columns=['A'], functions=[('B', gb.sum)])\n    t2.show()\n    +===+===+========+=====+=====+=====+\n    | # | C |function|(A=1)|(A=2)|(A=3)|\n    |row|int|  str   |mixed|mixed|mixed|\n    +---+---+--------+-----+-----+-----+\n    |0  |  6|Sum(B)  |    2|None |None |\n    |1  |  5|Sum(B)  |    4|None |None |\n    |2  |  4|Sum(B)  |None |    6|None |\n    |3  |  3|Sum(B)  |None |    8|None |\n    |4  |  2|Sum(B)  |None |None |   10|\n    |5  |  1|Sum(B)  |None |None |   12|\n    +===+===+========+=====+=====+=====+\n    ```\n    \"\"\"\n    return pivots.pivot(self, rows, columns, functions, values_as_rows, tqdm=tqdm, pbar=pbar)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.merge","title":"<code>tablite.core.Table.merge(left, right, new, criteria)</code>","text":"<p>takes from LEFT where criteria is True else RIGHT. :param: T: Table :param: criteria: np.array(bool):          if True take left column         else take right column :param left: (str) column name :param right: (str) column name :param new: (str) new name</p> <p>:returns: T</p> <p>Example:</p> <pre><code>&gt;&gt;&gt; c.show()\n+==+====+====+====+====+\n| #| A  | B  | C  | D  |\n+--+----+----+----+----+\n| 0|   1|  10|   1|  11|\n| 1|   2|  20|   2|  12|\n| 2|   3|None|   3|  13|\n| 3|None|  40|None|None|\n| 4|   5|  50|None|None|\n| 5|None|None|   6|  16|\n| 6|None|None|   7|  17|\n+==+====+====+====+====+\n\n&gt;&gt;&gt; c.merge(\"A\", \"C\", new=\"E\", criteria=[v != None for v in c['A']])\n&gt;&gt;&gt; c.show()\n+==+====+====+====+\n| #| B  | D  | E  |\n+--+----+----+----+\n| 0|  10|  11|   1|\n| 1|  20|  12|   2|\n| 2|None|  13|   3|\n| 3|  40|None|None|\n| 4|  50|None|   5|\n| 5|None|  16|   6|\n| 6|None|  17|   7|\n+==+====+====+====+\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>def merge(self, left, right, new, criteria):\n    \"\"\" takes from LEFT where criteria is True else RIGHT.\n    :param: T: Table\n    :param: criteria: np.array(bool): \n            if True take left column\n            else take right column\n    :param left: (str) column name\n    :param right: (str) column name\n    :param new: (str) new name\n\n    :returns: T\n\n    Example:\n    ```\n    &gt;&gt;&gt; c.show()\n    +==+====+====+====+====+\n    | #| A  | B  | C  | D  |\n    +--+----+----+----+----+\n    | 0|   1|  10|   1|  11|\n    | 1|   2|  20|   2|  12|\n    | 2|   3|None|   3|  13|\n    | 3|None|  40|None|None|\n    | 4|   5|  50|None|None|\n    | 5|None|None|   6|  16|\n    | 6|None|None|   7|  17|\n    +==+====+====+====+====+\n\n    &gt;&gt;&gt; c.merge(\"A\", \"C\", new=\"E\", criteria=[v != None for v in c['A']])\n    &gt;&gt;&gt; c.show()\n    +==+====+====+====+\n    | #| B  | D  | E  |\n    +--+----+----+----+\n    | 0|  10|  11|   1|\n    | 1|  20|  12|   2|\n    | 2|None|  13|   3|\n    | 3|  40|None|None|\n    | 4|  50|None|   5|\n    | 5|None|  16|   6|\n    | 6|None|  17|   7|\n    +==+====+====+====+\n    ```\n    \"\"\"\n    return merge.where(self, criteria,left,right,new)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.column_select","title":"<code>tablite.core.Table.column_select(cols: list[ColumnSelectorDict], tqdm=_tqdm, TaskManager=_TaskManager)</code>","text":"<p>type-casts columns from a given table to specified type(s)</p> cols <p>list of dicts: (example):</p> <pre><code>cols = [\n    {'column':'A', 'type': 'bool'},\n    {'column':'B', 'type': 'int', 'allow_empty': True},\n    {'column':'B', 'type': 'float', 'allow_empty': False, 'rename': 'C'},\n]\n</code></pre> <p>'column'     : column name of the input table that we want to type-cast 'type'       : type that we want to type-cast the specified column to 'allow_empty': should we allow empty values (None, str('')) through (Default: False) 'rename'     : new name of the column, if None will keep the original name, in case of duplicates suffix will be added (Default: None)</p> <p>supported types: 'bool', 'int', 'float', 'str', 'date', 'time', 'datetime'</p> <p>if any of the columns is rejected, entire row is rejected</p> <p>tqdm: progressbar constructor TaskManager: TaskManager constructor</p> (TABLE, TABLE) DESCRIPTION <p>first table contains the rows that were successfully cast to desired types</p> <p>second table contains rows that failed to cast + rejection reason</p> Source code in <code>tablite/core.py</code> <pre><code>def column_select(self, cols: list[ColumnSelectorDict], tqdm=_tqdm, TaskManager=_TaskManager):\n    \"\"\"\n    type-casts columns from a given table to specified type(s)\n\n    cols:\n        list of dicts: (example):\n\n            cols = [\n                {'column':'A', 'type': 'bool'},\n                {'column':'B', 'type': 'int', 'allow_empty': True},\n                {'column':'B', 'type': 'float', 'allow_empty': False, 'rename': 'C'},\n            ]\n\n        'column'     : column name of the input table that we want to type-cast\n        'type'       : type that we want to type-cast the specified column to\n        'allow_empty': should we allow empty values (None, str('')) through (Default: False)\n        'rename'     : new name of the column, if None will keep the original name, in case of duplicates suffix will be added (Default: None)\n\n        supported types: 'bool', 'int', 'float', 'str', 'date', 'time', 'datetime'\n\n        if any of the columns is rejected, entire row is rejected\n\n    tqdm: progressbar constructor\n    TaskManager: TaskManager constructor\n\n    returns: (Table, Table)\n        first table contains the rows that were successfully cast to desired types\n        second table contains rows that failed to cast + rejection reason\n    \"\"\"\n    return _column_select(self, cols, tqdm, TaskManager)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.join","title":"<code>tablite.core.Table.join(other, left_keys, right_keys, left_columns=None, right_columns=None, kind='inner', merge_keys=False, tqdm=_tqdm, pbar=None)</code>","text":"<p>short-cut for all join functions. kind: 'inner', 'left', 'outer', 'cross'</p> Source code in <code>tablite/core.py</code> <pre><code>def join(self, other, left_keys, right_keys, left_columns=None, right_columns=None, kind=\"inner\", merge_keys=False, tqdm=_tqdm, pbar=None):\n    \"\"\"\n    short-cut for all join functions.\n    kind: 'inner', 'left', 'outer', 'cross'\n    \"\"\"\n    kinds = {\n        \"inner\": self.inner_join,\n        \"left\": self.left_join,\n        \"outer\": self.outer_join,\n        \"cross\": self.cross_join,\n    }\n    if kind not in kinds:\n        raise ValueError(f\"join type unknown: {kind}\")\n    f = kinds.get(kind, None)\n    return f(other, left_keys, right_keys, left_columns, right_columns, merge_keys=merge_keys, tqdm=tqdm, pbar=pbar)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.left_join","title":"<code>tablite.core.Table.left_join(other, left_keys, right_keys, left_columns=None, right_columns=None, merge_keys=False, tqdm=_tqdm, pbar=None)</code>","text":"<p>:param other: self, other = (left, right) :param left_keys: list of keys for the join :param right_keys: list of keys for the join :param left_columns: list of left columns to retain, if None, all are retained. :param right_columns: list of right columns to retain, if None, all are retained. :return: new Table Example:</p> <pre><code>SQL:   SELECT number, letter FROM numbers LEFT JOIN letters ON numbers.colour == letters.color\nTablite: left_join = numbers.left_join(\n    letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter']\n)\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>def left_join(self, other, left_keys, right_keys, left_columns=None, right_columns=None, merge_keys=False, tqdm=_tqdm, pbar=None):\n    \"\"\"\n    :param other: self, other = (left, right)\n    :param left_keys: list of keys for the join\n    :param right_keys: list of keys for the join\n    :param left_columns: list of left columns to retain, if None, all are retained.\n    :param right_columns: list of right columns to retain, if None, all are retained.\n    :return: new Table\n    Example:\n    ```\n    SQL:   SELECT number, letter FROM numbers LEFT JOIN letters ON numbers.colour == letters.color\n    Tablite: left_join = numbers.left_join(\n        letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter']\n    )\n    ```\n    \"\"\"\n    return joins.left_join(self, other, left_keys, right_keys, left_columns, right_columns, merge_keys=merge_keys, tqdm=tqdm, pbar=pbar)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.inner_join","title":"<code>tablite.core.Table.inner_join(other, left_keys, right_keys, left_columns=None, right_columns=None, merge_keys=False, tqdm=_tqdm, pbar=None)</code>","text":"<p>:param other: self, other = (left, right) :param left_keys: list of keys for the join :param right_keys: list of keys for the join :param left_columns: list of left columns to retain, if None, all are retained. :param right_columns: list of right columns to retain, if None, all are retained. :return: new Table Example:</p> <pre><code>SQL:   SELECT number, letter FROM numbers JOIN letters ON numbers.colour == letters.color\nTablite: inner_join = numbers.inner_join(\n    letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter']\n    )\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>def inner_join(self, other, left_keys, right_keys, left_columns=None, right_columns=None, merge_keys=False, tqdm=_tqdm, pbar=None):\n    \"\"\"\n    :param other: self, other = (left, right)\n    :param left_keys: list of keys for the join\n    :param right_keys: list of keys for the join\n    :param left_columns: list of left columns to retain, if None, all are retained.\n    :param right_columns: list of right columns to retain, if None, all are retained.\n    :return: new Table\n    Example:\n    ```\n    SQL:   SELECT number, letter FROM numbers JOIN letters ON numbers.colour == letters.color\n    Tablite: inner_join = numbers.inner_join(\n        letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter']\n        )\n    ```\n    \"\"\"\n    return joins.inner_join(self, other, left_keys, right_keys, left_columns, right_columns, merge_keys=merge_keys, tqdm=tqdm, pbar=pbar)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.outer_join","title":"<code>tablite.core.Table.outer_join(other, left_keys, right_keys, left_columns=None, right_columns=None, merge_keys=False, tqdm=_tqdm, pbar=None)</code>","text":"<p>:param other: self, other = (left, right) :param left_keys: list of keys for the join :param right_keys: list of keys for the join :param left_columns: list of left columns to retain, if None, all are retained. :param right_columns: list of right columns to retain, if None, all are retained. :return: new Table Example:</p> <pre><code>SQL:   SELECT number, letter FROM numbers OUTER JOIN letters ON numbers.colour == letters.color\nTablite: outer_join = numbers.outer_join(\n    letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter']\n    )\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>def outer_join(self, other, left_keys, right_keys, left_columns=None, right_columns=None, merge_keys=False, tqdm=_tqdm, pbar=None):\n    \"\"\"\n    :param other: self, other = (left, right)\n    :param left_keys: list of keys for the join\n    :param right_keys: list of keys for the join\n    :param left_columns: list of left columns to retain, if None, all are retained.\n    :param right_columns: list of right columns to retain, if None, all are retained.\n    :return: new Table\n    Example:\n    ```\n    SQL:   SELECT number, letter FROM numbers OUTER JOIN letters ON numbers.colour == letters.color\n    Tablite: outer_join = numbers.outer_join(\n        letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter']\n        )\n    ```\n    \"\"\"\n    return joins.outer_join(self, other, left_keys, right_keys, left_columns, right_columns, merge_keys=merge_keys, tqdm=tqdm, pbar=pbar)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.cross_join","title":"<code>tablite.core.Table.cross_join(other, left_keys, right_keys, left_columns=None, right_columns=None, merge_keys=False, tqdm=_tqdm, pbar=None)</code>","text":"<p>CROSS JOIN returns the Cartesian product of rows from tables in the join. In other words, it will produce rows which combine each row from the first table with each row from the second table</p> Source code in <code>tablite/core.py</code> <pre><code>def cross_join(self, other, left_keys, right_keys, left_columns=None, right_columns=None, merge_keys=False, tqdm=_tqdm, pbar=None):\n    \"\"\"\n    CROSS JOIN returns the Cartesian product of rows from tables in the join.\n    In other words, it will produce rows which combine each row from the first table\n    with each row from the second table\n    \"\"\"\n    return joins.cross_join(self, other, left_keys, right_keys, left_columns, right_columns, merge_keys=merge_keys, tqdm=tqdm, pbar=pbar)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.lookup","title":"<code>tablite.core.Table.lookup(other, *criteria, all=True, tqdm=_tqdm)</code>","text":"<p>function for looking up values in <code>other</code> according to criteria in ascending order. :param: other: Table sorted in ascending search order. :param: criteria: Each criteria must be a tuple with value comparisons in the form:     (LEFT, OPERATOR, RIGHT) :param: all: boolean: True=ALL, False=Any</p> <p>OPERATOR must be a callable that returns a boolean LEFT must be a value that the OPERATOR can compare. RIGHT must be a value that the OPERATOR can compare.</p> <p>Examples:</p> <pre><code>('column A', \"==\", 'column B')  # comparison of two columns\n('Date', \"&lt;\", DataTypes.date(24,12) )  # value from column 'Date' is before 24/12.\nf = lambda L,R: all( ord(L) &lt; ord(R) )  # uses custom function.\n('text 1', f, 'text 2') value from column 'text 1' is compared with value from column 'text 2'\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>def lookup(self, other, *criteria, all=True, tqdm=_tqdm):\n    \"\"\"function for looking up values in `other` according to criteria in ascending order.\n    :param: other: Table sorted in ascending search order.\n    :param: criteria: Each criteria must be a tuple with value comparisons in the form:\n        (LEFT, OPERATOR, RIGHT)\n    :param: all: boolean: True=ALL, False=Any\n\n    OPERATOR must be a callable that returns a boolean\n    LEFT must be a value that the OPERATOR can compare.\n    RIGHT must be a value that the OPERATOR can compare.\n\n    Examples:\n    ```\n    ('column A', \"==\", 'column B')  # comparison of two columns\n    ('Date', \"&lt;\", DataTypes.date(24,12) )  # value from column 'Date' is before 24/12.\n    f = lambda L,R: all( ord(L) &lt; ord(R) )  # uses custom function.\n    ('text 1', f, 'text 2') value from column 'text 1' is compared with value from column 'text 2'\n    ```\n    \"\"\"\n    return lookup.lookup(self, other, *criteria, all=all, tqdm=tqdm)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.match","title":"<code>tablite.core.Table.match(other, *criteria, keep_left=None, keep_right=None)</code>","text":"<p>performs inner join where <code>T</code> matches <code>other</code> and removes rows that do not match.</p> <p>:param: T: Table :param: other: Table :param: criteria: Each criteria must be a tuple with value comparisons in the form:</p> <pre><code>(LEFT, OPERATOR, RIGHT), where operator must be \"==\"\n\nExample:\n    ('column A', \"==\", 'column B')\n\nThis syntax follows the lookup syntax. See Lookup for details.\n</code></pre> <p>:param: keep_left: list of columns to keep. :param: keep_right: list of right columns to keep.</p> Source code in <code>tablite/core.py</code> <pre><code>def match(self, other, *criteria, keep_left=None, keep_right=None):\n    \"\"\"\n    performs inner join where `T` matches `other` and removes rows that do not match.\n\n    :param: T: Table\n    :param: other: Table\n    :param: criteria: Each criteria must be a tuple with value comparisons in the form:\n\n        (LEFT, OPERATOR, RIGHT), where operator must be \"==\"\n\n        Example:\n            ('column A', \"==\", 'column B')\n\n        This syntax follows the lookup syntax. See Lookup for details.\n\n    :param: keep_left: list of columns to keep.\n    :param: keep_right: list of right columns to keep.\n    \"\"\"\n    return match.match(self, other, *criteria, keep_left=keep_left, keep_right=keep_right)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.replace_missing_values","title":"<code>tablite.core.Table.replace_missing_values(*args, **kwargs)</code>","text":"Source code in <code>tablite/core.py</code> <pre><code>def replace_missing_values(self, *args, **kwargs):\n    raise AttributeError(\"See imputation\")\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.imputation","title":"<code>tablite.core.Table.imputation(targets, missing=None, method='carry forward', sources=None, tqdm=_tqdm)</code>","text":"<p>In statistics, imputation is the process of replacing missing data with substituted values.</p> <p>See more: https://en.wikipedia.org/wiki/Imputation_(statistics)</p> PARAMETER  DESCRIPTION <code>table</code> <p>source table.</p> <p> TYPE: <code>Table</code> </p> <code>targets</code> <p>column names to find and replace missing values</p> <p> TYPE: <code>str or list of strings</code> </p> <code>missing</code> <p>values to be replaced.</p> <p> TYPE: <code>None or iterable</code> DEFAULT: <code>None</code> </p> <code>method</code> <p>method to be used for replacement. Options:</p> <p>'carry forward':     takes the previous value, and carries forward into fields     where values are missing.     +: quick. Realistic on time series.     -: Can produce strange outliers.</p> <p>'mean':     calculates the column mean (exclude <code>missing</code>) and copies     the mean in as replacement.     +: quick     -: doesn't work on text. Causes data set to drift towards the mean.</p> <p>'mode':     calculates the column mode (exclude <code>missing</code>) and copies     the mean in as replacement.     +: quick     -: most frequent value becomes over-represented in the sample</p> <p>'nearest neighbour':     calculates normalised distance between items in source columns     selects nearest neighbour and copies value as replacement.     +: works for any datatype.     -: computationally intensive (e.g. slow)</p> <p> TYPE: <code>str</code> DEFAULT: <code>'carry forward'</code> </p> <code>sources</code> <p>NEAREST NEIGHBOUR ONLY column names to be used during imputation. if None or empty, all columns will be used.</p> <p> TYPE: <code>list of strings</code> DEFAULT: <code>None</code> </p> RETURNS DESCRIPTION <code>table</code> <p>table with replaced values.</p> Source code in <code>tablite/core.py</code> <pre><code>def imputation(self, targets, missing=None, method=\"carry forward\", sources=None, tqdm=_tqdm):\n    \"\"\"\n    In statistics, imputation is the process of replacing missing data with substituted values.\n\n    See more: https://en.wikipedia.org/wiki/Imputation_(statistics)\n\n    Args:\n        table (Table): source table.\n\n        targets (str or list of strings): column names to find and\n            replace missing values\n\n        missing (None or iterable): values to be replaced.\n\n        method (str): method to be used for replacement. Options:\n\n            'carry forward':\n                takes the previous value, and carries forward into fields\n                where values are missing.\n                +: quick. Realistic on time series.\n                -: Can produce strange outliers.\n\n            'mean':\n                calculates the column mean (exclude `missing`) and copies\n                the mean in as replacement.\n                +: quick\n                -: doesn't work on text. Causes data set to drift towards the mean.\n\n            'mode':\n                calculates the column mode (exclude `missing`) and copies\n                the mean in as replacement.\n                +: quick\n                -: most frequent value becomes over-represented in the sample\n\n            'nearest neighbour':\n                calculates normalised distance between items in source columns\n                selects nearest neighbour and copies value as replacement.\n                +: works for any datatype.\n                -: computationally intensive (e.g. slow)\n\n        sources (list of strings): NEAREST NEIGHBOUR ONLY\n            column names to be used during imputation.\n            if None or empty, all columns will be used.\n\n    Returns:\n        table: table with replaced values.\n    \"\"\"\n    return imputation.imputation(self, targets, missing, method, sources, tqdm=tqdm)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.transpose","title":"<code>tablite.core.Table.transpose(tqdm=_tqdm)</code>","text":"Source code in <code>tablite/core.py</code> <pre><code>def transpose(self, tqdm=_tqdm):\n    return pivots.transpose(self, tqdm)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.pivot_transpose","title":"<code>tablite.core.Table.pivot_transpose(columns, keep=None, column_name='transpose', value_name='value', tqdm=_tqdm)</code>","text":"<p>Transpose a selection of columns to rows.</p> PARAMETER  DESCRIPTION <code>columns</code> <p>column names to transpose</p> <p> TYPE: <code>list of column names</code> </p> <code>keep</code> <p>column names to keep (repeat)</p> <p> TYPE: <code>list of column names</code> DEFAULT: <code>None</code> </p> RETURNS DESCRIPTION <code>Table</code> <p>with columns transposed to rows</p> Example <p>transpose columns 1,2 and 3 and transpose the remaining columns, except <code>sum</code>.</p> <p>Input:</p> <pre><code>| col1 | col2 | col3 | sun | mon | tue | ... | sat | sum  |\n|------|------|------|-----|-----|-----|-----|-----|------|\n| 1234 | 2345 | 3456 | 456 | 567 |     | ... |     | 1023 |\n| 1244 | 2445 | 4456 |     |   7 |     | ... |     |    7 |\n| ...  |      |      |     |     |     |     |     |      |\n\nt.transpose(keep=[col1, col2, col3], transpose=[sun,mon,tue,wed,thu,fri,sat])`\n\nOutput:\n\n|col1| col2| col3| transpose| value|\n|----|-----|-----|----------|------|\n|1234| 2345| 3456| sun      |   456|\n|1234| 2345| 3456| mon      |   567|\n|1244| 2445| 4456| mon      |     7|\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>def pivot_transpose(self, columns, keep=None, column_name=\"transpose\", value_name=\"value\", tqdm=_tqdm):\n    \"\"\"Transpose a selection of columns to rows.\n\n    Args:\n        columns (list of column names): column names to transpose\n        keep (list of column names): column names to keep (repeat)\n\n    Returns:\n        Table: with columns transposed to rows\n\n    Example:\n        transpose columns 1,2 and 3 and transpose the remaining columns, except `sum`.\n\n    Input:\n    ```\n    | col1 | col2 | col3 | sun | mon | tue | ... | sat | sum  |\n    |------|------|------|-----|-----|-----|-----|-----|------|\n    | 1234 | 2345 | 3456 | 456 | 567 |     | ... |     | 1023 |\n    | 1244 | 2445 | 4456 |     |   7 |     | ... |     |    7 |\n    | ...  |      |      |     |     |     |     |     |      |\n\n    t.transpose(keep=[col1, col2, col3], transpose=[sun,mon,tue,wed,thu,fri,sat])`\n\n    Output:\n\n    |col1| col2| col3| transpose| value|\n    |----|-----|-----|----------|------|\n    |1234| 2345| 3456| sun      |   456|\n    |1234| 2345| 3456| mon      |   567|\n    |1244| 2445| 4456| mon      |     7|\n    ```\n    \"\"\"\n    return pivots.pivot_transpose(self, columns, keep, column_name, value_name, tqdm=tqdm)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.diff","title":"<code>tablite.core.Table.diff(other, columns=None)</code>","text":"<p>compares table self with table other</p> PARAMETER  DESCRIPTION <code>self</code> <p>Table</p> <p> TYPE: <code>Table</code> </p> <code>other</code> <p>Table</p> <p> TYPE: <code>Table</code> </p> <code>columns</code> <p>list of column names to include in comparison. Defaults to None.</p> <p> TYPE: <code>List</code> DEFAULT: <code>None</code> </p> RETURNS DESCRIPTION <code>Table</code> <p>diff of self and other with diff in columns 1st and 2nd.</p> Source code in <code>tablite/core.py</code> <pre><code>def diff(self, other, columns=None):\n    \"\"\"compares table self with table other\n\n    Args:\n        self (Table): Table\n        other (Table): Table\n        columns (List, optional): list of column names to include in comparison. Defaults to None.\n\n    Returns:\n        Table: diff of self and other with diff in columns 1st and 2nd.\n    \"\"\"\n    return diff.diff(self, other, columns)\n</code></pre>"},{"location":"reference/core/#tablite.core-functions","title":"Functions","text":""},{"location":"reference/core/#tablite.core-modules","title":"Modules","text":""},{"location":"reference/datasets/","title":"Datasets","text":""},{"location":"reference/datasets/#tablite.datasets","title":"<code>tablite.datasets</code>","text":""},{"location":"reference/datasets/#tablite.datasets-classes","title":"Classes","text":""},{"location":"reference/datasets/#tablite.datasets-functions","title":"Functions","text":""},{"location":"reference/datasets/#tablite.datasets.synthetic_order_data","title":"<code>tablite.datasets.synthetic_order_data(rows=100000)</code>","text":"<p>Creates a synthetic dataset for testing that looks like this: (depending on number of rows)</p> <pre><code>+=========+=======+=============+===================+=====+===+=====+====+===+=====+=====+===================+==================+\n|    ~    |   #   |      1      |         2         |  3  | 4 |  5  | 6  | 7 |  8  |  9  |         10        |        11        |\n|   row   |  int  |     int     |      datetime     | int |int| int |str |str|mixed|mixed|       float       |      float       |\n+---------+-------+-------------+-------------------+-----+---+-----+----+---+-----+-----+-------------------+------------------+\n|0        |      1|1478158906743|2021-10-27 00:00:00|50764|  1|29990|C4-5|APP|21\u00b0  |None | 2.0434376837650046|1.3371665497020444|\n|1        |      2|2271295805011|2021-09-13 00:00:00|50141|  0|10212|C4-5|TAE|None |None |  1.010318612835485| 20.94821610676901|\n|2        |      3|1598726492913|2021-08-19 00:00:00|50527|  0|19416|C3-5|QPV|21\u00b0  |None |  1.463459515469516|  17.4133659842749|\n|3        |      4|1413615572689|2021-11-05 00:00:00|50181|  1|18637|C4-2|GCL|6\u00b0   |ABC  |  2.084002469706324| 0.489481411683505|\n|4        |      5| 245266998048|2021-09-25 00:00:00|50378|  0|29756|C5-4|LGY|6\u00b0   |XYZ  | 0.5141579343276079| 8.550780816571438|\n|5        |      6| 947994853644|2021-10-14 00:00:00|50511|  0| 7890|C2-4|BET|0\u00b0   |XYZ  | 1.1725893606177542| 7.447314130260951|\n|6        |      7|2230693047809|2021-10-07 00:00:00|50987|  1|26742|C1-3|CFP|0\u00b0   |XYZ  | 1.0921267279498004|11.009210185311993|\n|...      |...    |...          |...                |...  |...|...  |... |...|...  |...  |...                |...               |\n|7,999,993|7999994|2047223556745|2021-09-03 00:00:00|50883|  1|15687|C3-1|RFR|None |XYZ  | 1.3467185981566827|17.023443485654845|\n|7,999,994|7999995|1814140654790|2021-08-02 00:00:00|50152|  0|16556|C4-2|WTC|None |ABC  | 1.1517593924478968| 8.201818634721487|\n|7,999,995|7999996| 155308171103|2021-10-14 00:00:00|50008|  1|14590|C1-3|WYM|0\u00b0   |None | 2.1273836233717978|23.295943554889195|\n|7,999,996|7999997|1620451532911|2021-12-12 00:00:00|50173|  1|20744|C2-1|ZYO|6\u00b0   |ABC  |  2.482509134693724| 22.25375464857266|\n|7,999,997|7999998|1248987682094|2021-12-20 00:00:00|50052|  1|28298|C5-4|XAW|None |XYZ  |0.17923757926558143|23.728160892974252|\n|7,999,998|7999999|1382206732187|2021-11-13 00:00:00|50993|  1|24832|C5-2|UDL|None |ABC  |0.08425329763360942|12.707735293126758|\n|7,999,999|8000000| 600688069780|2021-09-28 00:00:00|50510|  0|15819|C3-4|IGY|None |ABC  |  1.066241687256579|13.862069804070295|\n+=========+=======+=============+===================+=====+===+=====+====+===+=====+=====+===================+==================+\n</code></pre> PARAMETER  DESCRIPTION <code>rows</code> <p>number of rows wanted. Defaults to 100_000.</p> <p> TYPE: <code>int</code> DEFAULT: <code>100000</code> </p> RETURNS DESCRIPTION <code>Table</code> <p>Populated table.</p> <p> TYPE: <code>Table</code> </p> Source code in <code>tablite/datasets.py</code> <pre><code>def synthetic_order_data(rows=100_000):\n    \"\"\"Creates a synthetic dataset for testing that looks like this:\n    (depending on number of rows)\n\n    ```\n    +=========+=======+=============+===================+=====+===+=====+====+===+=====+=====+===================+==================+\n    |    ~    |   #   |      1      |         2         |  3  | 4 |  5  | 6  | 7 |  8  |  9  |         10        |        11        |\n    |   row   |  int  |     int     |      datetime     | int |int| int |str |str|mixed|mixed|       float       |      float       |\n    +---------+-------+-------------+-------------------+-----+---+-----+----+---+-----+-----+-------------------+------------------+\n    |0        |      1|1478158906743|2021-10-27 00:00:00|50764|  1|29990|C4-5|APP|21\u00b0  |None | 2.0434376837650046|1.3371665497020444|\n    |1        |      2|2271295805011|2021-09-13 00:00:00|50141|  0|10212|C4-5|TAE|None |None |  1.010318612835485| 20.94821610676901|\n    |2        |      3|1598726492913|2021-08-19 00:00:00|50527|  0|19416|C3-5|QPV|21\u00b0  |None |  1.463459515469516|  17.4133659842749|\n    |3        |      4|1413615572689|2021-11-05 00:00:00|50181|  1|18637|C4-2|GCL|6\u00b0   |ABC  |  2.084002469706324| 0.489481411683505|\n    |4        |      5| 245266998048|2021-09-25 00:00:00|50378|  0|29756|C5-4|LGY|6\u00b0   |XYZ  | 0.5141579343276079| 8.550780816571438|\n    |5        |      6| 947994853644|2021-10-14 00:00:00|50511|  0| 7890|C2-4|BET|0\u00b0   |XYZ  | 1.1725893606177542| 7.447314130260951|\n    |6        |      7|2230693047809|2021-10-07 00:00:00|50987|  1|26742|C1-3|CFP|0\u00b0   |XYZ  | 1.0921267279498004|11.009210185311993|\n    |...      |...    |...          |...                |...  |...|...  |... |...|...  |...  |...                |...               |\n    |7,999,993|7999994|2047223556745|2021-09-03 00:00:00|50883|  1|15687|C3-1|RFR|None |XYZ  | 1.3467185981566827|17.023443485654845|\n    |7,999,994|7999995|1814140654790|2021-08-02 00:00:00|50152|  0|16556|C4-2|WTC|None |ABC  | 1.1517593924478968| 8.201818634721487|\n    |7,999,995|7999996| 155308171103|2021-10-14 00:00:00|50008|  1|14590|C1-3|WYM|0\u00b0   |None | 2.1273836233717978|23.295943554889195|\n    |7,999,996|7999997|1620451532911|2021-12-12 00:00:00|50173|  1|20744|C2-1|ZYO|6\u00b0   |ABC  |  2.482509134693724| 22.25375464857266|\n    |7,999,997|7999998|1248987682094|2021-12-20 00:00:00|50052|  1|28298|C5-4|XAW|None |XYZ  |0.17923757926558143|23.728160892974252|\n    |7,999,998|7999999|1382206732187|2021-11-13 00:00:00|50993|  1|24832|C5-2|UDL|None |ABC  |0.08425329763360942|12.707735293126758|\n    |7,999,999|8000000| 600688069780|2021-09-28 00:00:00|50510|  0|15819|C3-4|IGY|None |ABC  |  1.066241687256579|13.862069804070295|\n    +=========+=======+=============+===================+=====+===+=====+====+===+=====+=====+===================+==================+\n    ```\n\n    Args:\n        rows (int, optional): number of rows wanted. Defaults to 100_000.\n\n    Returns:\n        Table (Table): Populated table.\n    \"\"\"  # noqa\n    rows = int(rows)\n\n    L1 = [\"None\", \"0\u00b0\", \"6\u00b0\", \"21\u00b0\"]\n    L2 = [\"ABC\", \"XYZ\", \"\"]\n\n    t = Table()\n    assert isinstance(t, Table)\n    for page_n in range(math.ceil(rows / Config.PAGE_SIZE)):  # n pages\n        start = (page_n * Config.PAGE_SIZE)\n        end = min(start + Config.PAGE_SIZE, rows)\n        ro = range(start, end)\n\n        t2 = Table()\n        t2[\"#\"] = [v+1 for v in ro]\n        # 1 - mock orderid\n        t2[\"1\"] = [random.randint(18_778_628_504, 2277_772_117_504) for i in ro]\n        # 2 - mock delivery date.\n        t2[\"2\"] = [datetime.fromordinal(random.randint(738000, 738150)).isoformat() for i in ro]\n        # 3 - mock store id.\n        t2[\"3\"] = [random.randint(50000, 51000) for _ in ro]\n        # 4 - random bit.\n        t2[\"4\"] = [random.randint(0, 1) for _ in ro]\n        # 5 - mock product id\n        t2[\"5\"] = [random.randint(3000, 30000) for _ in ro]\n        # 6 - random weird string\n        t2[\"6\"] = [f\"C{random.randint(1, 5)}-{random.randint(1, 5)}\" for _ in ro]\n        # 7 - # random category\n        t2[\"7\"] = [\"\".join(random.choice(ascii_uppercase) for _ in range(3)) for _ in ro]\n        # 8 -random temperature group.\n        t2[\"8\"] = [random.choice(L1) for _ in ro]\n        # 9 - random choice of category\n        t2[\"9\"] = [random.choice(L2) for _ in ro]\n        # 10 - volume?\n        t2[\"10\"] = [random.uniform(0.01, 2.5) for _ in ro]\n        # 11 - units?\n        t2[\"11\"] = [f\"{random.uniform(0.1, 25)}\" for _ in ro]\n\n        if len(t) == 0:\n            t = t2\n        else:\n            t += t2\n\n    return t\n</code></pre>"},{"location":"reference/datatypes/","title":"Datatypes","text":""},{"location":"reference/datatypes/#tablite.datatypes","title":"<code>tablite.datatypes</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes-attributes","title":"Attributes","text":""},{"location":"reference/datatypes/#tablite.datatypes.matched_types","title":"<code>tablite.datatypes.matched_types = {int: DataTypes._infer_int, str: DataTypes._infer_str, float: DataTypes._infer_float, bool: DataTypes._infer_bool, date: DataTypes._infer_date, datetime: DataTypes._infer_datetime, time: DataTypes._infer_time}</code>  <code>module-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes-classes","title":"Classes","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes","title":"<code>tablite.datatypes.DataTypes</code>","text":"<p>             Bases: <code>object</code></p> <p>DataTypes is the conversion library for all datatypes.</p> <p>It supports any / all python datatypes.</p>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes-attributes","title":"Attributes","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.int","title":"<code>tablite.datatypes.DataTypes.int = int</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.str","title":"<code>tablite.datatypes.DataTypes.str = str</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.float","title":"<code>tablite.datatypes.DataTypes.float = float</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.bool","title":"<code>tablite.datatypes.DataTypes.bool = bool</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.date","title":"<code>tablite.datatypes.DataTypes.date = date</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.datetime","title":"<code>tablite.datatypes.DataTypes.datetime = datetime</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.time","title":"<code>tablite.datatypes.DataTypes.time = time</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.timedelta","title":"<code>tablite.datatypes.DataTypes.timedelta = timedelta</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.numeric_types","title":"<code>tablite.datatypes.DataTypes.numeric_types = {int, float, date, time, datetime}</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.epoch","title":"<code>tablite.datatypes.DataTypes.epoch = datetime(2000, 1, 1, 0, 0, 0, 0, timezone.utc)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.epoch_no_tz","title":"<code>tablite.datatypes.DataTypes.epoch_no_tz = datetime(2000, 1, 1, 0, 0, 0, 0)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.digits","title":"<code>tablite.datatypes.DataTypes.digits = '1234567890'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.decimals","title":"<code>tablite.datatypes.DataTypes.decimals = set('1234567890-+eE.')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.integers","title":"<code>tablite.datatypes.DataTypes.integers = set('1234567890-+')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.nones","title":"<code>tablite.datatypes.DataTypes.nones = {'null', 'Null', 'NULL', '#N/A', '#n/a', '', 'None', None, np.nan}</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.none_type","title":"<code>tablite.datatypes.DataTypes.none_type = type(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.bytes_functions","title":"<code>tablite.datatypes.DataTypes.bytes_functions = {type(None): b_none, bool: b_bool, int: b_int, float: b_float, str: b_str, bytes: b_bytes, datetime: b_datetime, date: b_date, time: b_time, timedelta: b_timedelta}</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.type_code_functions","title":"<code>tablite.datatypes.DataTypes.type_code_functions = {1: _none, 2: _bool, 3: _int, 4: _float, 5: _str, 6: _bytes, 7: _datetime, 8: _date, 9: _time, 10: _timedelta, 11: _unpickle}</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.pytype_from_type_code","title":"<code>tablite.datatypes.DataTypes.pytype_from_type_code = {1: type(None), 2: bool, 3: int, 4: float, 5: str, 6: bytes, 7: datetime, 8: date, 9: time, 10: timedelta, 11: 'pickled object'}</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.date_formats","title":"<code>tablite.datatypes.DataTypes.date_formats = {'NNNN-NN-NN': lambda x: date(*int(i) for i in x.split('-')), 'NNNN-N-NN': lambda x: date(*int(i) for i in x.split('-')), 'NNNN-NN-N': lambda x: date(*int(i) for i in x.split('-')), 'NNNN-N-N': lambda x: date(*int(i) for i in x.split('-')), 'NN-NN-NNNN': lambda x: date(*[int(i) for i in x.split('-')][::-1]), 'N-NN-NNNN': lambda x: date(*[int(i) for i in x.split('-')][::-1]), 'NN-N-NNNN': lambda x: date(*[int(i) for i in x.split('-')][::-1]), 'N-N-NNNN': lambda x: date(*[int(i) for i in x.split('-')][::-1]), 'NNNN.NN.NN': lambda x: date(*int(i) for i in x.split('.')), 'NNNN.N.NN': lambda x: date(*int(i) for i in x.split('.')), 'NNNN.NN.N': lambda x: date(*int(i) for i in x.split('.')), 'NNNN.N.N': lambda x: date(*int(i) for i in x.split('.')), 'NN.NN.NNNN': lambda x: date(*[int(i) for i in x.split('.')][::-1]), 'N.NN.NNNN': lambda x: date(*[int(i) for i in x.split('.')][::-1]), 'NN.N.NNNN': lambda x: date(*[int(i) for i in x.split('.')][::-1]), 'N.N.NNNN': lambda x: date(*[int(i) for i in x.split('.')][::-1]), 'NNNN/NN/NN': lambda x: date(*int(i) for i in x.split('/')), 'NNNN/N/NN': lambda x: date(*int(i) for i in x.split('/')), 'NNNN/NN/N': lambda x: date(*int(i) for i in x.split('/')), 'NNNN/N/N': lambda x: date(*int(i) for i in x.split('/')), 'NN/NN/NNNN': lambda x: date(*[int(i) for i in x.split('/')][::-1]), 'N/NN/NNNN': lambda x: date(*[int(i) for i in x.split('/')][::-1]), 'NN/N/NNNN': lambda x: date(*[int(i) for i in x.split('/')][::-1]), 'N/N/NNNN': lambda x: date(*[int(i) for i in x.split('/')][::-1]), 'NNNN NN NN': lambda x: date(*int(i) for i in x.split(' ')), 'NNNN N NN': lambda x: date(*int(i) for i in x.split(' ')), 'NNNN NN N': lambda x: date(*int(i) for i in x.split(' ')), 'NNNN N N': lambda x: date(*int(i) for i in x.split(' ')), 'NN NN NNNN': lambda x: date(*[int(i) for i in x.split(' ')][::-1]), 'N N NNNN': lambda x: date(*[int(i) for i in x.split(' ')][::-1]), 'NN N NNNN': lambda x: date(*[int(i) for i in x.split(' ')][::-1]), 'N NN NNNN': lambda x: date(*[int(i) for i in x.split(' ')][::-1]), 'NNNNNNNN': lambda x: date(*(int(x[:4]), int(x[4:6]), int(x[6:])))}</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.datetime_formats","title":"<code>tablite.datatypes.DataTypes.datetime_formats = {'NNNN-NN-NNTNN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x), 'NNNN-NN-NNTNN:NN': lambda x: DataTypes.pattern_to_datetime(x), 'NNNN-NN-NN NN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, T=' '), 'NNNN-NN-NN NN:NN': lambda x: DataTypes.pattern_to_datetime(x, T=' '), 'NNNN/NN/NNTNN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/'), 'NNNN/NN/NNTNN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/'), 'NNNN/NN/NN NN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/', T=' '), 'NNNN/NN/NN NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/', T=' '), 'NNNN NN NNTNN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd=' '), 'NNNN NN NNTNN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd=' '), 'NNNN NN NN NN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd=' ', T=' '), 'NNNN NN NN NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd=' ', T=' '), 'NNNN.NN.NNTNN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='.'), 'NNNN.NN.NNTNN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='.'), 'NNNN.NN.NN NN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='.', T=' '), 'NNNN.NN.NN NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='.', T=' '), 'NN-NN-NNNNTNN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='-', T=' ', day_first=True), 'NN-NN-NNNNTNN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='-', T=' ', day_first=True), 'NN-NN-NNNN NN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='-', T=' ', day_first=True), 'NN-NN-NNNN NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='-', T=' ', day_first=True), 'NN/NN/NNNNTNN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/', day_first=True), 'NN/NN/NNNNTNN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/', day_first=True), 'NN/NN/NNNN NN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/', T=' ', day_first=True), 'NN/NN/NNNN NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/', T=' ', day_first=True), 'NN NN NNNNTNN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/', day_first=True), 'NN NN NNNNTNN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/', day_first=True), 'NN NN NNNN NN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/', day_first=True), 'NN NN NNNN NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/', day_first=True), 'NN.NN.NNNNTNN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='.', day_first=True), 'NN.NN.NNNNTNN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='.', day_first=True), 'NN.NN.NNNN NN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='.', day_first=True), 'NN.NN.NNNN NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='.', day_first=True), 'NNNNNNNNTNNNNNN': lambda x: DataTypes.pattern_to_datetime(x, compact=1), 'NNNNNNNNTNNNN': lambda x: DataTypes.pattern_to_datetime(x, compact=1), 'NNNNNNNNTNN': lambda x: DataTypes.pattern_to_datetime(x, compact=1), 'NNNNNNNNNN': lambda x: DataTypes.pattern_to_datetime(x, compact=2), 'NNNNNNNNNNNN': lambda x: DataTypes.pattern_to_datetime(x, compact=2), 'NNNNNNNNNNNNNN': lambda x: DataTypes.pattern_to_datetime(x, compact=2), 'NNNNNNNNTNN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, compact=3)}</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.types","title":"<code>tablite.datatypes.DataTypes.types = [datetime, date, time, int, bool, float, str]</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes-functions","title":"Functions","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.type_code","title":"<code>tablite.datatypes.DataTypes.type_code(value)</code>  <code>classmethod</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>@classmethod\ndef type_code(cls, value):\n    if type(value) in cls._type_codes:\n        return cls._type_codes[type(value)]\n    elif hasattr(value, \"dtype\"):\n        dtype = pytype(value)\n        return cls._type_codes[dtype]\n    else:\n        return cls._type_codes[\"pickle\"]\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.b_none","title":"<code>tablite.datatypes.DataTypes.b_none(v)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def b_none(v):\n    return b\"None\"\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.b_bool","title":"<code>tablite.datatypes.DataTypes.b_bool(v)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def b_bool(v):\n    return bytes(str(v), encoding=\"utf-8\")\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.b_int","title":"<code>tablite.datatypes.DataTypes.b_int(v)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def b_int(v):\n    return bytes(str(v), encoding=\"utf-8\")\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.b_float","title":"<code>tablite.datatypes.DataTypes.b_float(v)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def b_float(v):\n    return bytes(str(v), encoding=\"utf-8\")\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.b_str","title":"<code>tablite.datatypes.DataTypes.b_str(v)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def b_str(v):\n    return v.encode(\"utf-8\")\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.b_bytes","title":"<code>tablite.datatypes.DataTypes.b_bytes(v)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def b_bytes(v):\n    return v\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.b_datetime","title":"<code>tablite.datatypes.DataTypes.b_datetime(v)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def b_datetime(v):\n    return bytes(v.isoformat(), encoding=\"utf-8\")\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.b_date","title":"<code>tablite.datatypes.DataTypes.b_date(v)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def b_date(v):\n    return bytes(v.isoformat(), encoding=\"utf-8\")\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.b_time","title":"<code>tablite.datatypes.DataTypes.b_time(v)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def b_time(v):\n    return bytes(v.isoformat(), encoding=\"utf-8\")\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.b_timedelta","title":"<code>tablite.datatypes.DataTypes.b_timedelta(v)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def b_timedelta(v):\n    return bytes(str(float(v.days + (v.seconds / (24 * 60 * 60)))), \"utf-8\")\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.b_pickle","title":"<code>tablite.datatypes.DataTypes.b_pickle(v)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def b_pickle(v):\n    return pickle.dumps(v, protocol=0)\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.to_bytes","title":"<code>tablite.datatypes.DataTypes.to_bytes(v)</code>  <code>classmethod</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>@classmethod\ndef to_bytes(cls, v):\n    if type(v) in cls.bytes_functions:  # it's a python native type\n        f = cls.bytes_functions[type(v)]\n    elif hasattr(v, \"dtype\"):  # it's a numpy/c type.\n        dtype = pytype(v)\n        f = cls.bytes_functions[dtype]\n    else:\n        f = cls.b_pickle\n    return f(v)\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.from_type_code","title":"<code>tablite.datatypes.DataTypes.from_type_code(value, code)</code>  <code>classmethod</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>@classmethod\ndef from_type_code(cls, value, code):\n    f = cls.type_code_functions[code]\n    return f(value)\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.pattern_to_datetime","title":"<code>tablite.datatypes.DataTypes.pattern_to_datetime(iso_string, ymd=None, T=None, compact=0, day_first=False)</code>  <code>staticmethod</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>@staticmethod\ndef pattern_to_datetime(iso_string, ymd=None, T=None, compact=0, day_first=False):\n    assert isinstance(iso_string, str)\n    if compact:\n        s = iso_string\n        if compact == 1:  # has T\n            slices = [\n                (0, 4, \"-\"),\n                (4, 6, \"-\"),\n                (6, 8, \"T\"),\n                (9, 11, \":\"),\n                (11, 13, \":\"),\n                (13, len(s), \"\"),\n            ]\n        elif compact == 2:  # has no T.\n            slices = [\n                (0, 4, \"-\"),\n                (4, 6, \"-\"),\n                (6, 8, \"T\"),\n                (8, 10, \":\"),\n                (10, 12, \":\"),\n                (12, len(s), \"\"),\n            ]\n        elif compact == 3:  # has T and :\n            slices = [\n                (0, 4, \"-\"),\n                (4, 6, \"-\"),\n                (6, 8, \"T\"),\n                (9, 11, \":\"),\n                (12, 14, \":\"),\n                (15, len(s), \"\"),\n            ]\n        else:\n            raise TypeError\n        iso_string = \"\".join([s[a:b] + c for a, b, c in slices if b &lt;= len(s)])\n        iso_string = iso_string.rstrip(\":\")\n\n    if day_first:\n        s = iso_string\n        iso_string = \"\".join((s[6:10], \"-\", s[3:5], \"-\", s[0:2], s[10:]))\n\n    if \",\" in iso_string:\n        iso_string = iso_string.replace(\",\", \".\")\n\n    dot = iso_string[::-1].find(\".\")\n    if 0 &lt; dot &lt; 10:\n        ix = len(iso_string) - dot\n        microsecond = int(float(f\"0{iso_string[ix - 1:]}\") * 10**6)\n        # fmt:off\n        iso_string = iso_string[: len(iso_string) - dot] + str(microsecond).rjust(6, \"0\")\n        # fmt:on\n    if ymd:\n        iso_string = iso_string.replace(ymd, \"-\", 2)\n    if T:\n        iso_string = iso_string.replace(T, \"T\")\n    return datetime.fromisoformat(iso_string)\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.round","title":"<code>tablite.datatypes.DataTypes.round(value, multiple, up=None)</code>  <code>classmethod</code>","text":"<p>a nicer way to round numbers.</p> PARAMETER  DESCRIPTION <code>value</code> <p>value to be rounded</p> <p> TYPE: <code>(float, integer, datetime)</code> </p> <code>multiple</code> <p>value to be used as the based of rounding. 1) multiple = 1 is the same as rounding to whole integers. 2) multiple = 0.001 is the same as rounding to 3 digits precision. 3) mulitple = 3.1415 is rounding to nearest multiplier of 3.1415 4) value = datetime(2022,8,18,11,14,53,440) 5) multiple = timedelta(hours=0.5) 6) xround(value,multiple) is datetime(2022,8,18,11,0)</p> <p> TYPE: <code>(float, integer, timedelta)</code> </p> <code>up</code> <p>None (default) or boolean rounds half, up or down. round(1.6, 1) rounds to 2. round(1.4, 1) rounds to 1. round(1.5, 1, up=True) rounds to 2. round(1.5, 1, up=False) rounds to 1.</p> <p> TYPE: <code>(None, bool)</code> DEFAULT: <code>None</code> </p> RETURNS DESCRIPTION <p>float,integer,datetime: rounded value in same type as input.</p> Source code in <code>tablite/datatypes.py</code> <pre><code>@classmethod\ndef round(cls, value, multiple, up=None):\n    \"\"\"a nicer way to round numbers.\n\n    Args:\n        value (float,integer,datetime): value to be rounded\n\n        multiple (float,integer,timedelta): value to be used as the based of rounding.\n            1) multiple = 1 is the same as rounding to whole integers.\n            2) multiple = 0.001 is the same as rounding to 3 digits precision.\n            3) mulitple = 3.1415 is rounding to nearest multiplier of 3.1415\n            4) value = datetime(2022,8,18,11,14,53,440)\n            5) multiple = timedelta(hours=0.5)\n            6) xround(value,multiple) is datetime(2022,8,18,11,0)\n\n        up (None, bool, optional):\n            None (default) or boolean rounds half, up or down.\n            round(1.6, 1) rounds to 2.\n            round(1.4, 1) rounds to 1.\n            round(1.5, 1, up=True) rounds to 2.\n            round(1.5, 1, up=False) rounds to 1.\n\n    Returns:\n        float,integer,datetime: rounded value in same type as input.\n    \"\"\"\n    epoch = 0\n    if isinstance(value, (datetime)) and isinstance(multiple, timedelta):\n        if value.tzinfo is None:\n            epoch = cls.epoch_no_tz\n        else:\n            epoch = cls.epoch\n\n    value2 = value - epoch\n    if value2 == 0:\n        return value2\n\n    low = (value2 // multiple) * multiple\n    high = low + multiple\n    if up is True:\n        return high + epoch\n    elif up is False:\n        return low + epoch\n    else:\n        if abs((high + epoch) - value) &lt; abs(value - (low + epoch)):\n            return high + epoch\n        else:\n            return low + epoch\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.to_json","title":"<code>tablite.datatypes.DataTypes.to_json(v)</code>  <code>staticmethod</code>","text":"<p>converts any python type to json.</p> PARAMETER  DESCRIPTION <code>v</code> <p>value to convert to json</p> <p> TYPE: <code>any</code> </p> RETURNS DESCRIPTION <p>json compatible value from v</p> Source code in <code>tablite/datatypes.py</code> <pre><code>@staticmethod\ndef to_json(v):\n    \"\"\"converts any python type to json.\n\n    Args:\n        v (any): value to convert to json\n\n    Returns:\n        json compatible value from v\n    \"\"\"\n    if hasattr(v, \"dtype\"):\n        v = numpy_to_python(v)\n    if v is None:\n        return v\n    elif v is False:\n        # using isinstance(v, bool): won't work as False also is int of zero.\n        return str(v)\n    elif v is True:\n        return str(v)\n    elif isinstance(v, int):\n        return v\n    elif isinstance(v, str):\n        return v\n    elif isinstance(v, float):\n        return v\n    elif isinstance(v, datetime):\n        return v.isoformat()\n    elif isinstance(v, time):\n        return v.isoformat()\n    elif isinstance(v, date):\n        return v.isoformat()\n    elif isinstance(v, timedelta):\n        return f\"P{v.days}DT{v.seconds + (v.microseconds / 1e6)}S\"\n    else:\n        raise TypeError(f\"The datatype {type(v)} is not supported.\")\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.from_json","title":"<code>tablite.datatypes.DataTypes.from_json(v, dtype)</code>  <code>staticmethod</code>","text":"<p>converts json to python datatype</p> PARAMETER  DESCRIPTION <code>v</code> <p>value</p> <p> TYPE: <code>any</code> </p> <code>dtype</code> <p>any python type</p> <p> TYPE: <code>python type</code> </p> RETURNS DESCRIPTION <p>python type of value v</p> Source code in <code>tablite/datatypes.py</code> <pre><code>@staticmethod\ndef from_json(v, dtype):\n    \"\"\"converts json to python datatype\n\n    Args:\n        v (any): value\n        dtype (python type): any python type\n\n    Returns:\n        python type of value v\n    \"\"\"\n    if v in DataTypes.nones:\n        if dtype is str and v == \"\":\n            return \"\"\n        else:\n            return None\n    if dtype is int:\n        return int(v)\n    elif dtype is str:\n        return str(v)\n    elif dtype is float:\n        return float(v)\n    elif dtype is bool:\n        if v == \"False\":\n            return False\n        elif v == \"True\":\n            return True\n        else:\n            raise ValueError(v)\n    elif dtype is date:\n        return date.fromisoformat(v)\n    elif dtype is datetime:\n        return datetime.fromisoformat(v)\n    elif dtype is time:\n        return time.fromisoformat(v)\n    elif dtype is timedelta:\n        L = v.split(\"DT\")\n        days = int(L[0].lstrip(\"P\"))\n        seconds = float(L[1].rstrip(\"S\"))\n        return timedelta(days, seconds)\n    else:\n        raise TypeError(f\"The datatype {str(dtype)} is not supported.\")\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.guess_types","title":"<code>tablite.datatypes.DataTypes.guess_types(*values)</code>  <code>staticmethod</code>","text":"<p>Attempts to guess the datatype for *values returns dict with matching datatypes and probabilities</p> RETURNS DESCRIPTION <code>dict</code> <p>{key: type, value: probability}</p> Source code in <code>tablite/datatypes.py</code> <pre><code>@staticmethod\ndef guess_types(*values):\n    \"\"\"Attempts to guess the datatype for *values\n    returns dict with matching datatypes and probabilities\n\n    Returns:\n        dict: {key: type, value: probability}\n    \"\"\"\n    d = defaultdict(int)\n    probability = Rank(DataTypes.types[:])\n\n    for value in values:\n        if hasattr(value, \"dtype\"):\n            value = numpy_to_python(value)\n\n        for dtype in probability:\n            try:\n                _ = DataTypes.infer(value, dtype)\n                d[dtype] += 1\n                probability.match(dtype)\n                break\n            except (ValueError, TypeError):\n                pass\n    if not d:\n        d[str] = len(values)\n    return {k: round(v / len(values), 3) for k, v in d.items()}\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.guess","title":"<code>tablite.datatypes.DataTypes.guess(*values)</code>  <code>staticmethod</code>","text":"<p>Makes a best guess the datatype for *values returns list of native python values</p> RETURNS DESCRIPTION <code>list</code> <p>list of native python values</p> Source code in <code>tablite/datatypes.py</code> <pre><code>@staticmethod\ndef guess(*values):\n    \"\"\"Makes a best guess the datatype for *values\n    returns list of native python values\n\n    Returns:\n        list: list of native python values\n    \"\"\"\n    probability = Rank(*DataTypes.types[:])\n    matches = [None for _ in values[0]]\n\n    for ix, value in enumerate(values[0]):\n        if hasattr(value, \"dtype\"):\n            value = numpy_to_python(value)\n        for dtype in probability:\n            try:\n                matches[ix] = DataTypes.infer(value, dtype)\n                probability.match(dtype)\n                break\n            except (ValueError, TypeError):\n                pass\n    return matches\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.infer","title":"<code>tablite.datatypes.DataTypes.infer(v, dtype)</code>  <code>classmethod</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>@classmethod\ndef infer(cls, v, dtype):\n    if isinstance(v, str) and dtype == str:\n        # we got a string, we're trying to infer it to string, we shouldn't check for None-ness\n        return v\n\n    if v in DataTypes.nones:\n        return None\n\n    if dtype not in matched_types:\n        raise TypeError(f\"The datatype {str(dtype)} is not supported.\")\n\n    return matched_types[dtype](v)\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.Rank","title":"<code>tablite.datatypes.Rank(*items)</code>","text":"<p>             Bases: <code>object</code></p> Source code in <code>tablite/datatypes.py</code> <pre><code>def __init__(self, *items):\n    self.items = {i: ix for i, ix in zip(items, range(len(items)))}\n    self.ranks = [0 for _ in items]\n    self.items_list = [i for i in items]\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.Rank-attributes","title":"Attributes","text":""},{"location":"reference/datatypes/#tablite.datatypes.Rank.items","title":"<code>tablite.datatypes.Rank.items = {i: ixfor (i, ix) in zip(items, range(len(items)))}</code>  <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.Rank.ranks","title":"<code>tablite.datatypes.Rank.ranks = [0 for _ in items]</code>  <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.Rank.items_list","title":"<code>tablite.datatypes.Rank.items_list = [i for i in items]</code>  <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.Rank-functions","title":"Functions","text":""},{"location":"reference/datatypes/#tablite.datatypes.Rank.match","title":"<code>tablite.datatypes.Rank.match(k)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def match(self, k):  # k+=1\n    ix = self.items[k]\n    r = self.ranks\n    r[ix] += 1\n\n    if ix &gt; 0:\n        p = self.items_list\n        while (\n            r[ix] &gt; r[ix - 1] and ix &gt; 0\n        ):  # use a simple bubble sort to maintain rank\n            r[ix], r[ix - 1] = r[ix - 1], r[ix]\n            p[ix], p[ix - 1] = p[ix - 1], p[ix]\n            old = p[ix]\n            self.items[old] = ix\n            self.items[k] = ix - 1\n            ix -= 1\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.Rank.__iter__","title":"<code>tablite.datatypes.Rank.__iter__()</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def __iter__(self):\n    return iter(self.items_list)\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.MetaArray","title":"<code>tablite.datatypes.MetaArray</code>","text":"<p>             Bases: <code>ndarray</code></p> <p>Array with metadata.</p>"},{"location":"reference/datatypes/#tablite.datatypes.MetaArray-functions","title":"Functions","text":""},{"location":"reference/datatypes/#tablite.datatypes.MetaArray.__new__","title":"<code>tablite.datatypes.MetaArray.__new__(array, dtype=None, order=None, **kwargs)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def __new__(cls, array, dtype=None, order=None, **kwargs):\n    obj = np.asarray(array, dtype=dtype, order=order).view(cls)\n    obj.metadata = kwargs\n    return obj\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.MetaArray.__array_finalize__","title":"<code>tablite.datatypes.MetaArray.__array_finalize__(obj)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def __array_finalize__(self, obj):\n    if obj is None:\n        return\n    self.metadata = getattr(obj, \"metadata\", None)\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes-functions","title":"Functions","text":""},{"location":"reference/datatypes/#tablite.datatypes.numpy_to_python","title":"<code>tablite.datatypes.numpy_to_python(obj: Any) -&gt; Any</code>","text":"<p>Converts numpy types to python types.</p> <p>See https://numpy.org/doc/stable/reference/arrays.scalars.html</p> PARAMETER  DESCRIPTION <code>obj</code> <p>A numpy object</p> <p> TYPE: <code>Any</code> </p> RETURNS DESCRIPTION <code>Any</code> <p>python object: A python object</p> Source code in <code>tablite/datatypes.py</code> <pre><code>def numpy_to_python(obj: Any) -&gt; Any:\n    \"\"\"Converts numpy types to python types.\n\n    See https://numpy.org/doc/stable/reference/arrays.scalars.html\n\n    Args:\n        obj (Any): A numpy object\n\n    Returns:\n        python object: A python object\n    \"\"\"\n    if isinstance(obj, np.generic):\n        return obj.item()\n    return obj\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.pytype","title":"<code>tablite.datatypes.pytype(obj)</code>","text":"<p>Returns the python type of any object</p> PARAMETER  DESCRIPTION <code>obj</code> <p>any numpy or python object</p> <p> TYPE: <code>Any</code> </p> RETURNS DESCRIPTION <code>type</code> <p>type of obj</p> Source code in <code>tablite/datatypes.py</code> <pre><code>def pytype(obj):\n    \"\"\"Returns the python type of any object\n\n    Args:\n        obj (Any): any numpy or python object\n\n    Returns:\n        type: type of obj\n    \"\"\"\n    if isinstance(obj, np.generic):\n        return type(obj.item())\n    return type(obj)\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.pytype_from_iterable","title":"<code>tablite.datatypes.pytype_from_iterable(iterable: {tuple, list}) -&gt; {np.dtype, dict}</code>","text":"<p>helper to make correct np array from python types.</p> PARAMETER  DESCRIPTION <code>iterable</code> <p>values to be converted to numpy array.</p> <p> TYPE: <code>(tuple, list)</code> </p> RAISES DESCRIPTION <code>NotImplementedError</code> <p>if datatype is not supported.</p> RETURNS DESCRIPTION <code>{dtype, dict}</code> <p>np.dtype: python type of the iterable.</p> Source code in <code>tablite/datatypes.py</code> <pre><code>def pytype_from_iterable(iterable: {tuple, list}) -&gt; {np.dtype, dict}:\n    \"\"\"helper to make correct np array from python types.\n\n    Args:\n        iterable (tuple,list): values to be converted to numpy array.\n\n    Raises:\n        NotImplementedError: if datatype is not supported.\n\n    Returns:\n        np.dtype: python type of the iterable.\n    \"\"\"\n    py_types = {}\n    if isinstance(iterable, (tuple, list)):\n        type_counter = Counter((pytype(v) for v in iterable))\n\n        for k, v in type_counter.items():\n            py_types[k] = v\n\n        if len(py_types) == 0:\n            np_dtype, py_dtype = object, bool\n        elif len(py_types) == 1:\n            py_dtype = list(py_types.keys())[0]\n            if py_dtype == datetime:\n                np_dtype = np.datetime64\n            elif py_dtype == date:\n                np_dtype = np.datetime64\n            elif py_dtype == timedelta:\n                np_dtype = np.timedelta64\n            else:\n                np_dtype = None\n        else:\n            np_dtype = object\n    elif isinstance(iterable, np.ndarray):\n        if iterable.dtype == object:\n            np_dtype = object\n            py_types = dict(Counter((pytype(v) for v in iterable)))\n        else:\n            np_dtype = iterable.dtype\n            if len(iterable) &gt; 0:\n                py_types = {pytype(iterable[0]): len(iterable)}\n            else:\n                py_types = {pytype(np_dtype.type()): len(iterable)}\n    else:\n        raise NotImplementedError(f\"No handler for {type(iterable)}\")\n\n    return np_dtype, py_types\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.list_to_np_array","title":"<code>tablite.datatypes.list_to_np_array(iterable)</code>","text":"<p>helper to make correct np array from python types. Example of problem where numpy turns mixed types into strings.</p> <p>np.array([4, '5']) np.ndarray(['4', '5'])</p> RETURNS DESCRIPTION <p>np.array</p> <p>datatypes</p> Source code in <code>tablite/datatypes.py</code> <pre><code>def list_to_np_array(iterable):\n    \"\"\"helper to make correct np array from python types.\n    Example of problem where numpy turns mixed types into strings.\n    &gt;&gt;&gt; np.array([4, '5'])\n    np.ndarray(['4', '5'])\n\n    returns:\n        np.array\n        datatypes\n    \"\"\"\n    np_dtype, py_dtype = pytype_from_iterable(iterable)\n\n    value = MetaArray(iterable, dtype=np_dtype, py_dtype=py_dtype)\n    return value\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.np_type_unify","title":"<code>tablite.datatypes.np_type_unify(arrays)</code>","text":"<p>unifies numpy types.</p> PARAMETER  DESCRIPTION <code>arrays</code> <p>List of numpy arrays</p> <p> TYPE: <code>list</code> </p> RETURNS DESCRIPTION <p>np.ndarray: numpy array of a single type.</p> Source code in <code>tablite/datatypes.py</code> <pre><code>def np_type_unify(arrays):\n    \"\"\"unifies numpy types.\n\n    Args:\n        arrays (list): List of numpy arrays\n\n    Returns:\n        np.ndarray: numpy array of a single type.\n    \"\"\"\n    dtypes = {arr.dtype: len(arr) for arr in arrays}\n    if len(dtypes) == 1:\n        dtype, _ = dtypes.popitem()\n    else:\n        for ix, arr in enumerate(arrays):\n            arrays[ix] = np.array(arr, dtype=object)\n        dtype = object\n    return np.concatenate(arrays, dtype=dtype)\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.multitype_set","title":"<code>tablite.datatypes.multitype_set(arr)</code>","text":"<p>prevents loss of True, False when calling sets.</p> <p>python looses values when called returning a set. Example:</p> <p>{1, True, 0, False}</p> PARAMETER  DESCRIPTION <code>arr</code> <p>iterable of mixed types.</p> <p> TYPE: <code>Iterable</code> </p> RETURNS DESCRIPTION <p>np.array: with unique values.</p> Source code in <code>tablite/datatypes.py</code> <pre><code>def multitype_set(arr):\n    \"\"\"prevents loss of True, False when calling sets.\n\n    python looses values when called returning a set. Example:\n    &gt;&gt;&gt; {1, True, 0, False}\n    {0,1}\n\n    Args:\n        arr (Iterable): iterable of mixed types.\n\n    Returns:\n        np.array: with unique values.\n    \"\"\"\n    L = [(type(v), v) for v in arr]\n    L = list(set(L))\n    L = [v for _, v in L]\n    return np.array(L, dtype=object)\n</code></pre>"},{"location":"reference/diff/","title":"Diff","text":""},{"location":"reference/diff/#tablite.diff","title":"<code>tablite.diff</code>","text":""},{"location":"reference/diff/#tablite.diff-classes","title":"Classes","text":""},{"location":"reference/diff/#tablite.diff-functions","title":"Functions","text":""},{"location":"reference/diff/#tablite.diff.diff","title":"<code>tablite.diff.diff(T, other, columns=None)</code>","text":"<p>compares table self with table other</p> PARAMETER  DESCRIPTION <code>self</code> <p>Table</p> <p> TYPE: <code>Table</code> </p> <code>other</code> <p>Table</p> <p> TYPE: <code>Table</code> </p> <code>columns</code> <p>list of column names to include in comparison. Defaults to None.</p> <p> TYPE: <code>List</code> DEFAULT: <code>None</code> </p> RETURNS DESCRIPTION <code>Table</code> <p>diff of self and other with diff in columns 1st and 2nd.</p> Source code in <code>tablite/diff.py</code> <pre><code>def diff(T, other, columns=None):\n    \"\"\"compares table self with table other\n\n    Args:\n        self (Table): Table\n        other (Table): Table\n        columns (List, optional): list of column names to include in comparison. Defaults to None.\n\n    Returns:\n        Table: diff of self and other with diff in columns 1st and 2nd.\n    \"\"\"\n    sub_cls_check(T, BaseTable)\n    sub_cls_check(other, BaseTable)\n    if columns is None:\n        columns = [name for name in T.columns if name in other.columns]\n    elif isinstance(columns, list) and all(isinstance(i, str) for i in columns):\n        for name in columns:\n            if name not in T.columns:\n                raise ValueError(f\"column '{name}' not found\")\n            if name not in other.columns:\n                raise ValueError(f\"column '{name}' not found\")\n    else:\n        raise TypeError(\"Expected list of column names\")\n\n    t1 = T[columns]\n    if issubclass(type(t1), BaseTable):\n        t1 = [tuple(r) for r in T.rows]\n    else:\n        t1 = list(T)\n    t2 = other[columns]\n    if issubclass(type(t2), BaseTable):\n        t2 = [tuple(r) for r in other.rows]\n    else:\n        t2 = list(other)\n\n    sm = difflib.SequenceMatcher(None, t1, t2)\n    new = type(T)()\n    first = unique_name(\"1st\", columns)\n    second = unique_name(\"2nd\", columns)\n    new.add_columns(*columns + [first, second])\n\n    news = {n: [] for n in new.columns}  # Cache for Work in progress.\n\n    for opc, t1a, t1b, t2a, t2b in sm.get_opcodes():\n        if opc == \"insert\":\n            for name, col in zip(columns, zip(*t2[t2a:t2b])):\n                news[name].extend(col)\n            news[first] += [\"-\"] * (t2b - t2a)\n            news[second] += [\"+\"] * (t2b - t2a)\n\n        elif opc == \"delete\":\n            for name, col in zip(columns, zip(*t1[t1a:t1b])):\n                news[name].extend(col)\n            news[first] += [\"+\"] * (t1b - t1a)\n            news[second] += [\"-\"] * (t1b - t1a)\n\n        elif opc == \"equal\":\n            for name, col in zip(columns, zip(*t2[t2a:t2b])):\n                news[name].extend(col)\n            news[first] += [\"=\"] * (t2b - t2a)\n            news[second] += [\"=\"] * (t2b - t2a)\n\n        elif opc == \"replace\":\n            for name, col in zip(columns, zip(*t2[t2a:t2b])):\n                news[name].extend(col)\n            news[first] += [\"r\"] * (t2b - t2a)\n            news[second] += [\"r\"] * (t2b - t2a)\n\n        else:\n            pass\n\n        # Clear cache to free up memory.\n        if len(news[first]) &gt; Config.PAGE_SIZE == 0:\n            for name, L in news.items():\n                new[name].extend(np.array(L))\n                L.clear()\n\n    for name, L in news.items():\n        new[name].extend(np.array(L))\n        L.clear()\n    return new\n</code></pre>"},{"location":"reference/export_utils/","title":"Export utils","text":""},{"location":"reference/export_utils/#tablite.export_utils","title":"<code>tablite.export_utils</code>","text":""},{"location":"reference/export_utils/#tablite.export_utils-classes","title":"Classes","text":""},{"location":"reference/export_utils/#tablite.export_utils-functions","title":"Functions","text":""},{"location":"reference/export_utils/#tablite.export_utils.to_sql","title":"<code>tablite.export_utils.to_sql(table, name)</code>","text":"<p>generates ANSI-92 compliant SQL.</p> PARAMETER  DESCRIPTION <code>name</code> <p>name of SQL table.</p> <p> TYPE: <code>str</code> </p> Source code in <code>tablite/export_utils.py</code> <pre><code>def to_sql(table, name):\n    \"\"\"\n    generates ANSI-92 compliant SQL.\n\n    args:\n        name (str): name of SQL table.\n    \"\"\"\n    sub_cls_check(table, BaseTable)\n    type_check(name, str)\n\n    prefix = name\n    name = \"T1\"\n    create_table = \"\"\"CREATE TABLE {} ({})\"\"\"\n    columns = []\n    for name, col in table.columns.items():\n        dtype = col.types()\n        if len(dtype) == 1:\n            dtype, _ = dtype.popitem()\n            if dtype is int:\n                dtype = \"INTEGER\"\n            elif dtype is float:\n                dtype = \"REAL\"\n            else:\n                dtype = \"TEXT\"\n        else:\n            dtype = \"TEXT\"\n        definition = f\"{name} {dtype}\"\n        columns.append(definition)\n\n    create_table = create_table.format(prefix, \", \".join(columns))\n\n    # return create_table\n    row_inserts = []\n    for row in table.rows:\n        row_inserts.append(str(tuple([i if i is not None else \"NULL\" for i in row])))\n    row_inserts = f\"INSERT INTO {prefix} VALUES \" + \",\".join(row_inserts)\n    return \"begin; {}; {}; commit;\".format(create_table, row_inserts)\n</code></pre>"},{"location":"reference/export_utils/#tablite.export_utils.to_pandas","title":"<code>tablite.export_utils.to_pandas(table)</code>","text":"<p>returns pandas.DataFrame</p> Source code in <code>tablite/export_utils.py</code> <pre><code>def to_pandas(table):\n    \"\"\"\n    returns pandas.DataFrame\n    \"\"\"\n    sub_cls_check(table, BaseTable)\n    try:\n        return pd.DataFrame(table.to_dict())  # noqa\n    except ImportError:\n        import pandas as pd  # noqa\n    return pd.DataFrame(table.to_dict())  # noqa\n</code></pre>"},{"location":"reference/export_utils/#tablite.export_utils.to_hdf5","title":"<code>tablite.export_utils.to_hdf5(table, path)</code>","text":"<p>creates a copy of the table as hdf5</p> <p>Note that some loss of type information is to be expected in columns of mixed type:</p> <p>t.show(dtype=True) +===+===+=====+=====+====+=====+=====+===================+==========+========+===============+===+=========================+=====+===+ | # | A |  B  |  C  | D  |  E  |  F  |         G         |    H     |   I    |       J       | K |            L            |  M  | O | |row|int|mixed|float|str |mixed| bool|      datetime     |   date   |  time  |   timedelta   |str|           int           |float|int| +---+---+-----+-----+----+-----+-----+-------------------+----------+--------+---------------+---+-------------------------+-----+---+ | 0 | -1|None | -1.1|    |None |False|2023-06-09 09:12:06|2023-06-09|09:12:06| 1 day, 0:00:00|b  |-100000000000000000000000|  inf| 11| | 1 |  1|    1|  1.1|1000|1    | True|2023-06-09 09:12:06|2023-06-09|09:12:06|2 days, 0:06:40|\u55e8  | 100000000000000000000000| -inf|-11| +===+===+=====+=====+====+=====+=====+===================+==========+========+===============+===+=========================+=====+===+ t.to_hdf5(filename) t2 = Table.from_hdf5(filename) t2.show(dtype=True) +===+===+=====+=====+=====+=====+=====+===================+===================+========+===============+===+=========================+=====+===+ | # | A |  B  |  C  |  D  |  E  |  F  |         G         |         H         |   I    |       J       | K |            L            |  M  | O | |row|int|mixed|float|mixed|mixed| bool|      datetime     |      datetime     |  time  |      str      |str|           int           |float|int| +---+---+-----+-----+-----+-----+-----+-------------------+-------------------+--------+---------------+---+-------------------------+-----+---+ | 0 | -1|None | -1.1|None |None |False|2023-06-09 09:12:06|2023-06-09 00:00:00|09:12:06|1 day, 0:00:00 |b  |-100000000000000000000000|  inf| 11| | 1 |  1|    1|  1.1| 1000|    1| True|2023-06-09 09:12:06|2023-06-09 00:00:00|09:12:06|2 days, 0:06:40|\u55e8  | 100000000000000000000000| -inf|-11| +===+===+=====+=====+=====+=====+=====+===================+===================+========+===============+===+=========================+=====+===+</p> Source code in <code>tablite/export_utils.py</code> <pre><code>def to_hdf5(table, path):\n    # fmt: off\n    \"\"\"\n    creates a copy of the table as hdf5\n\n    Note that some loss of type information is to be expected in columns of mixed type:\n    &gt;&gt;&gt; t.show(dtype=True)\n    +===+===+=====+=====+====+=====+=====+===================+==========+========+===============+===+=========================+=====+===+\n    | # | A |  B  |  C  | D  |  E  |  F  |         G         |    H     |   I    |       J       | K |            L            |  M  | O |\n    |row|int|mixed|float|str |mixed| bool|      datetime     |   date   |  time  |   timedelta   |str|           int           |float|int|\n    +---+---+-----+-----+----+-----+-----+-------------------+----------+--------+---------------+---+-------------------------+-----+---+\n    | 0 | -1|None | -1.1|    |None |False|2023-06-09 09:12:06|2023-06-09|09:12:06| 1 day, 0:00:00|b  |-100000000000000000000000|  inf| 11|\n    | 1 |  1|    1|  1.1|1000|1    | True|2023-06-09 09:12:06|2023-06-09|09:12:06|2 days, 0:06:40|\u55e8  | 100000000000000000000000| -inf|-11|\n    +===+===+=====+=====+====+=====+=====+===================+==========+========+===============+===+=========================+=====+===+\n    &gt;&gt;&gt; t.to_hdf5(filename)\n    &gt;&gt;&gt; t2 = Table.from_hdf5(filename)\n    &gt;&gt;&gt; t2.show(dtype=True)\n    +===+===+=====+=====+=====+=====+=====+===================+===================+========+===============+===+=========================+=====+===+\n    | # | A |  B  |  C  |  D  |  E  |  F  |         G         |         H         |   I    |       J       | K |            L            |  M  | O |\n    |row|int|mixed|float|mixed|mixed| bool|      datetime     |      datetime     |  time  |      str      |str|           int           |float|int|\n    +---+---+-----+-----+-----+-----+-----+-------------------+-------------------+--------+---------------+---+-------------------------+-----+---+\n    | 0 | -1|None | -1.1|None |None |False|2023-06-09 09:12:06|2023-06-09 00:00:00|09:12:06|1 day, 0:00:00 |b  |-100000000000000000000000|  inf| 11|\n    | 1 |  1|    1|  1.1| 1000|    1| True|2023-06-09 09:12:06|2023-06-09 00:00:00|09:12:06|2 days, 0:06:40|\u55e8  | 100000000000000000000000| -inf|-11|\n    +===+===+=====+=====+=====+=====+=====+===================+===================+========+===============+===+=========================+=====+===+\n    \"\"\"\n    # fmt: in\n    import h5py\n\n    sub_cls_check(table, BaseTable)\n    type_check(path, Path)\n\n    total = f\"{len(table.columns) * len(table):,}\"  # noqa\n    print(f\"writing {total} records to {path}\", end=\"\")\n\n    with h5py.File(path, \"w\") as f:\n        n = 0\n        for name, col in table.items():\n            try:\n                f.create_dataset(name, data=col[:])  # stored in hdf5 as '/name'\n            except TypeError:\n                f.create_dataset(name, data=[str(i) for i in col[:]])  # stored in hdf5 as '/name'\n            n += 1\n    print(\"... done\")\n</code></pre>"},{"location":"reference/export_utils/#tablite.export_utils.excel_writer","title":"<code>tablite.export_utils.excel_writer(table, path)</code>","text":"<p>writer for excel files.</p> <p>This can create xlsx files beyond Excels. If you're using pyexcel to read the data, you'll see the data is there. If you're using Excel, Excel will stop loading after 1,048,576 rows.</p> <p>See pyexcel for more details: http://docs.pyexcel.org/</p> Source code in <code>tablite/export_utils.py</code> <pre><code>def excel_writer(table, path):\n    \"\"\"\n    writer for excel files.\n\n    This can create xlsx files beyond Excels.\n    If you're using pyexcel to read the data, you'll see the data is there.\n    If you're using Excel, Excel will stop loading after 1,048,576 rows.\n\n    See pyexcel for more details:\n    http://docs.pyexcel.org/\n    \"\"\"\n    import pyexcel\n\n    sub_cls_check(table, BaseTable)\n    type_check(path, Path)\n\n    def gen(table):  # local helper\n        yield table.columns\n        for row in table.rows:\n            yield row\n\n    data = list(gen(table))\n    if path.suffix in [\".xls\", \".ods\"]:\n        data = [\n            [str(v) if (isinstance(v, (int, float)) and abs(v) &gt; 2**32 - 1) else DataTypes.to_json(v) for v in row]\n            for row in data\n        ]\n\n    pyexcel.save_as(array=data, dest_file_name=str(path))\n</code></pre>"},{"location":"reference/export_utils/#tablite.export_utils.to_json","title":"<code>tablite.export_utils.to_json(table, *args, **kwargs)</code>","text":"Source code in <code>tablite/export_utils.py</code> <pre><code>def to_json(table, *args, **kwargs):\n    import json\n\n    sub_cls_check(table, BaseTable)\n    return json.dumps(table.as_json_serializable())\n</code></pre>"},{"location":"reference/export_utils/#tablite.export_utils.path_suffix_check","title":"<code>tablite.export_utils.path_suffix_check(path, kind)</code>","text":"Source code in <code>tablite/export_utils.py</code> <pre><code>def path_suffix_check(path, kind):\n    if not path.suffix == kind:\n        raise ValueError(f\"Suffix mismatch: Expected {kind}, got {path.suffix} in {path.name}\")\n    if not path.parent.exists():\n        raise FileNotFoundError(f\"directory {path.parent} not found.\")\n</code></pre>"},{"location":"reference/export_utils/#tablite.export_utils.text_writer","title":"<code>tablite.export_utils.text_writer(table, path, tqdm=_tqdm)</code>","text":"<p>exports table to csv, tsv or txt dependening on path suffix. follows the JSON norm. text escape is ON for all strings.</p>"},{"location":"reference/export_utils/#tablite.export_utils.text_writer--note","title":"Note:","text":"<p>If the delimiter is present in a string when the string is exported, text-escape is required, as the format otherwise is corrupted. When the file is being written, it is unknown whether any string in a column contrains the delimiter. As text escaping the few strings that may contain the delimiter would lead to an assymmetric format, the safer guess is to text escape all strings.</p> Source code in <code>tablite/export_utils.py</code> <pre><code>def text_writer(table, path, tqdm=_tqdm):\n    \"\"\"exports table to csv, tsv or txt dependening on path suffix.\n    follows the JSON norm. text escape is ON for all strings.\n\n    Note:\n    ----------------------\n    If the delimiter is present in a string when the string is exported,\n    text-escape is required, as the format otherwise is corrupted.\n    When the file is being written, it is unknown whether any string in\n    a column contrains the delimiter. As text escaping the few strings\n    that may contain the delimiter would lead to an assymmetric format,\n    the safer guess is to text escape all strings.\n    \"\"\"\n    sub_cls_check(table, BaseTable)\n    type_check(path, Path)\n\n    def txt(value):  # helper for text writer\n        if value is None:\n            return \"\"  # A column with 1,None,2 must be \"1,,2\".\n        elif isinstance(value, str):\n            # if not (value.startswith('\"') and value.endswith('\"')):\n            #     return f'\"{value}\"'  # this must be escape: \"the quick fox, jumped over the comma\"\n            # else:\n            return value  # this would for example be an empty string: \"\"\n        else:\n            return str(DataTypes.to_json(value))  # this handles datetimes, timedelta, etc.\n\n    delimiters = {\".csv\": \",\", \".tsv\": \"\\t\", \".txt\": \"|\"}\n    delimiter = delimiters.get(path.suffix)\n\n    with path.open(\"w\", encoding=\"utf-8\") as fo:\n        fo.write(delimiter.join(c for c in table.columns) + \"\\n\")\n        for row in tqdm(table.rows, total=len(table), disable=Config.TQDM_DISABLE):\n            fo.write(delimiter.join(txt(c) for c in row) + \"\\n\")\n</code></pre>"},{"location":"reference/export_utils/#tablite.export_utils.sql_writer","title":"<code>tablite.export_utils.sql_writer(table, path)</code>","text":"Source code in <code>tablite/export_utils.py</code> <pre><code>def sql_writer(table, path):\n    type_check(table, BaseTable)\n    type_check(path, Path)\n    with path.open(\"w\", encoding=\"utf-8\") as fo:\n        fo.write(to_sql(table))\n</code></pre>"},{"location":"reference/export_utils/#tablite.export_utils.json_writer","title":"<code>tablite.export_utils.json_writer(table, path)</code>","text":"Source code in <code>tablite/export_utils.py</code> <pre><code>def json_writer(table, path):\n    type_check(table, BaseTable)\n    type_check(path, Path)\n    with path.open(\"w\") as fo:\n        fo.write(to_json(table))\n</code></pre>"},{"location":"reference/export_utils/#tablite.export_utils.to_html","title":"<code>tablite.export_utils.to_html(table, path)</code>","text":"Source code in <code>tablite/export_utils.py</code> <pre><code>def to_html(table, path):\n    type_check(table, BaseTable)\n    type_check(path, Path)\n    with path.open(\"w\", encoding=\"utf-8\") as fo:\n        fo.write(table._repr_html_(slice(0, len(table))))\n</code></pre>"},{"location":"reference/file_reader_utils/","title":"File reader utils","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils","title":"<code>tablite.file_reader_utils</code>","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils-attributes","title":"Attributes","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.ENCODING_GUESS_BYTES","title":"<code>tablite.file_reader_utils.ENCODING_GUESS_BYTES = 10000</code>  <code>module-attribute</code>","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.header_readers","title":"<code>tablite.file_reader_utils.header_readers = {'fods': excel_reader_headers, 'json': excel_reader_headers, 'simple': excel_reader_headers, 'rst': excel_reader_headers, 'mediawiki': excel_reader_headers, 'xlsx': excel_reader_headers, 'xlsm': excel_reader_headers, 'csv': text_reader_headers, 'tsv': text_reader_headers, 'txt': text_reader_headers, 'ods': ods_reader_headers}</code>  <code>module-attribute</code>","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils-classes","title":"Classes","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.TextEscape","title":"<code>tablite.file_reader_utils.TextEscape(openings='({[', closures=']})', text_qualifier='\"', delimiter=',', strip_leading_and_tailing_whitespace=False)</code>","text":"<p>             Bases: <code>object</code></p> <p>enables parsing of CSV with respecting brackets and text marks.</p> <p>Example: text_escape = TextEscape()  # set up the instance. for line in somefile.readlines():     list_of_words = text_escape(line)  # use the instance.     ...</p> <p>As an example, the Danes and Germans use \" for inches and ' for feet, so we will see data that contains nail (75 x 4 mm, 3\" x 3/12\"), so for this case ( and ) are valid escapes, but \" and ' aren't.</p> Source code in <code>tablite/file_reader_utils.py</code> <pre><code>def __init__(\n    self,\n    openings=\"({[\",\n    closures=\"]})\",\n    text_qualifier='\"',\n    delimiter=\",\",\n    strip_leading_and_tailing_whitespace=False,\n):\n    \"\"\"\n    As an example, the Danes and Germans use \" for inches and ' for feet,\n    so we will see data that contains nail (75 x 4 mm, 3\" x 3/12\"), so\n    for this case ( and ) are valid escapes, but \" and ' aren't.\n\n    \"\"\"\n    if openings is None:\n        openings = [None]\n    elif isinstance(openings, str):\n        self.openings = {c for c in openings}\n    else:\n        raise TypeError(f\"expected str, got {type(openings)}\")\n\n    if closures is None:\n        closures = [None]\n    elif isinstance(closures, str):\n        self.closures = {c for c in closures}\n    else:\n        raise TypeError(f\"expected str, got {type(closures)}\")\n\n    if not isinstance(delimiter, str):\n        raise TypeError(f\"expected str, got {type(delimiter)}\")\n    self.delimiter = delimiter\n    self._delimiter_length = len(delimiter)\n    self.strip_leading_and_tailing_whitespace = strip_leading_and_tailing_whitespace\n\n    if text_qualifier is None:\n        pass\n    elif text_qualifier in openings + closures:\n        raise ValueError(\"It's a bad idea to have qoute character appears in openings or closures.\")\n    else:\n        self.qoute = text_qualifier\n\n    if not text_qualifier:\n        if not self.strip_leading_and_tailing_whitespace:\n            self.c = self._call_1\n        else:\n            self.c = self._call_2\n    else:\n        self.c = self._call_3\n</code></pre>"},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.TextEscape-attributes","title":"Attributes","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.TextEscape.openings","title":"<code>tablite.file_reader_utils.TextEscape.openings = {c for c in openings}</code>  <code>instance-attribute</code>","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.TextEscape.closures","title":"<code>tablite.file_reader_utils.TextEscape.closures = {c for c in closures}</code>  <code>instance-attribute</code>","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.TextEscape.delimiter","title":"<code>tablite.file_reader_utils.TextEscape.delimiter = delimiter</code>  <code>instance-attribute</code>","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.TextEscape.strip_leading_and_tailing_whitespace","title":"<code>tablite.file_reader_utils.TextEscape.strip_leading_and_tailing_whitespace = strip_leading_and_tailing_whitespace</code>  <code>instance-attribute</code>","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.TextEscape.qoute","title":"<code>tablite.file_reader_utils.TextEscape.qoute = text_qualifier</code>  <code>instance-attribute</code>","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.TextEscape.c","title":"<code>tablite.file_reader_utils.TextEscape.c = self._call_1</code>  <code>instance-attribute</code>","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.TextEscape-functions","title":"Functions","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.TextEscape.__call__","title":"<code>tablite.file_reader_utils.TextEscape.__call__(s)</code>","text":"Source code in <code>tablite/file_reader_utils.py</code> <pre><code>def __call__(self, s):\n    return self.c(s)\n</code></pre>"},{"location":"reference/file_reader_utils/#tablite.file_reader_utils-functions","title":"Functions","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.split_by_sequence","title":"<code>tablite.file_reader_utils.split_by_sequence(text, sequence)</code>","text":"<p>helper to split text according to a split sequence.</p> Source code in <code>tablite/file_reader_utils.py</code> <pre><code>def split_by_sequence(text, sequence):\n    \"\"\"helper to split text according to a split sequence.\"\"\"\n    chunks = tuple()\n    for element in sequence:\n        idx = text.find(element)\n        if idx &lt; 0:\n            raise ValueError(f\"'{element}' not in row\")\n        chunk, text = text[:idx], text[len(element) + idx :]\n        chunks += (chunk,)\n    chunks += (text,)  # the remaining text.\n    return chunks\n</code></pre>"},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.detect_seperator","title":"<code>tablite.file_reader_utils.detect_seperator(text)</code>","text":"<p>:param path: pathlib.Path objects :param encoding: file encoding. :return: 1 character.</p> Source code in <code>tablite/file_reader_utils.py</code> <pre><code>def detect_seperator(text):\n    \"\"\"\n    :param path: pathlib.Path objects\n    :param encoding: file encoding.\n    :return: 1 character.\n    \"\"\"\n    # After reviewing the logic in the CSV sniffer, I concluded that all it\n    # really does is to look for a non-text character. As the separator is\n    # determined by the first line, which almost always is a line of headers,\n    # the text characters will be utf-8,16 or ascii letters plus white space.\n    # This leaves the characters ,;:| and \\t as potential separators, with one\n    # exception: files that use whitespace as separator. My logic is therefore\n    # to (1) find the set of characters that intersect with ',;:|\\t' which in\n    # practice is a single character, unless (2) it is empty whereby it must\n    # be whitespace.\n    if len(text) == 0:\n        return None\n    seps = {\",\", \"\\t\", \";\", \":\", \"|\"}.intersection(text)\n    if not seps:\n        if \" \" in text:\n            return \" \"\n        if \"\\n\" in text:\n            return \"\\n\"\n        else:\n            raise ValueError(\"separator not detected\")\n    if len(seps) == 1:\n        return seps.pop()\n    else:\n        frq = [(text.count(i), i) for i in seps]\n        frq.sort(reverse=True)  # most frequent first.\n        return frq[0][-1]\n</code></pre>"},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.text_reader_headers","title":"<code>tablite.file_reader_utils.text_reader_headers(path, delimiter, header_row_index, text_qualifier, linecount)</code>","text":"Source code in <code>tablite/file_reader_utils.py</code> <pre><code>def text_reader_headers(path, delimiter, header_row_index, text_qualifier, linecount):\n    d = {}\n    delimiters = {\n        \".csv\": \",\",\n        \".tsv\": \"\\t\",\n        \".txt\": None,\n    }\n\n    try:\n        with path.open(\"rb\") as fi:\n            rawdata = fi.read(ENCODING_GUESS_BYTES)\n            encoding = chardet.detect(rawdata)[\"encoding\"]\n\n        if delimiter is None:\n            with path.open(\"r\", encoding=encoding, errors=\"ignore\") as fi:\n                lines = []\n                for n, line in enumerate(fi, -header_row_index):\n                    if n &lt; 0:\n                        continue\n                    line = line.rstrip(\"\\n\")\n                    lines.append(line)\n                    if n &gt;= linecount:\n                        break  # break on first\n                try:\n                    d[\"delimiter\"] = delimiter = detect_seperator(\"\\n\".join(lines))\n                except ValueError as e:\n                    if e.args == (\"separator not detected\", ):\n                        d[\"delimiter\"] = delimiter = None # this will handle the case of 1 column, 1 row\n                    else:\n                        raise e\n\n        if delimiter is None:\n            d[\"delimiter\"] = delimiter = delimiters[path.suffix]  # pickup the default one\n            d[path.name] = [lines]\n            d[\"is_empty\"] = True  # mark as empty to return an empty table instead of throwing\n        else:\n            kwargs = {}\n\n            if text_qualifier is not None:\n                kwargs[\"text_qualifier\"] = text_qualifier\n                kwargs[\"quoting\"] = \"QUOTE_MINIMAL\"\n            else:\n                kwargs[\"quoting\"] = \"QUOTE_NONE\"\n\n            d[path.name] = _get_headers(\n                str(path), py_to_nim_encoding(encoding), header_row_index=header_row_index,\n                delimiter=delimiter,\n                linecount=linecount,\n                **kwargs\n            )\n        return d\n    except Exception as e:\n        raise ValueError(f\"can't read {path.suffix}\")\n</code></pre>"},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.excel_reader_headers","title":"<code>tablite.file_reader_utils.excel_reader_headers(path, delimiter, header_row_index, text_qualifier, linecount)</code>","text":"Source code in <code>tablite/file_reader_utils.py</code> <pre><code>def excel_reader_headers(path, delimiter, header_row_index, text_qualifier, linecount):\n    d = {}\n    book = openpyxl.open(str(path), read_only=True)\n\n    try:\n        all_sheets = book.sheetnames\n\n        for sheet_name, sheet in ((name, book[name]) for name in all_sheets):\n            fixup_worksheet(sheet)\n            if sheet.max_row is None:\n                max_rows = 0\n            else:\n                max_rows = min(sheet.max_row, linecount + 1)\n            container = [None] * max_rows\n            padding_ends = 0\n            max_column = sheet.max_column\n\n            for i, row_data in enumerate(sheet.iter_rows(0, header_row_index + max_rows, values_only=True), start=-header_row_index):\n                if i &lt; 0:\n                    # NOTE: for some reason `iter_rows` specifying a start row starts reading cells as binary, instead skip the rows that are before our first read row\n                    continue\n\n                # NOTE: text readers do not cast types and give back strings, neither should xlsx reader, can't find documentation if it's possible to ignore this via `iter_rows` instead of casting back to string\n                container[i] = [DataTypes.to_json(v) for v in row_data]\n\n                for j, cell in enumerate(reversed(row_data)):\n                    if cell is None:\n                        continue\n\n                    padding_ends = max(padding_ends, max_column - j)\n\n                    break\n\n            d[sheet_name] = [None if c is None else c[0:padding_ends] for c in container]\n            d[\"delimiter\"] = None\n    finally:\n        book.close()\n\n    return d\n</code></pre>"},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.ods_reader_headers","title":"<code>tablite.file_reader_utils.ods_reader_headers(path, delimiter, header_row_index, text_qualifier, linecount)</code>","text":"Source code in <code>tablite/file_reader_utils.py</code> <pre><code>def ods_reader_headers(path, delimiter, header_row_index, text_qualifier, linecount):\n    d = {\n        \"delimiter\": None\n    }\n    sheets = pyexcel.get_book_dict(file_name=str(path))\n\n    for sheet_name, data in sheets.items():\n        lines = [[DataTypes.to_json(v) for v in row] for row in data[header_row_index:header_row_index+linecount]]\n\n        d[sheet_name] = lines\n\n    return d\n</code></pre>"},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.get_headers","title":"<code>tablite.file_reader_utils.get_headers(path, delimiter=None, header_row_index=0, text_qualifier=None, linecount=10)</code>","text":"<p>file format definition csv     comma separated values tsv     tab separated values csvz        a zip file that contains one or many csv files tsvz        a zip file that contains one or many tsv files xls     a spreadsheet file format created by MS-Excel 97-2003 xlsx        MS-Excel Extensions to the Office Open XML SpreadsheetML File Format. xlsm        an MS-Excel Macro-Enabled Workbook file ods     open document spreadsheet fods        flat open document spreadsheet json        java script object notation html        html table of the data structure simple      simple presentation rst     rStructured Text presentation of the data mediawiki   media wiki table</p> Source code in <code>tablite/file_reader_utils.py</code> <pre><code>def get_headers(path, delimiter=None, header_row_index=0, text_qualifier=None, linecount=10):\n    \"\"\"\n    file format\tdefinition\n    csv\t    comma separated values\n    tsv\t    tab separated values\n    csvz\ta zip file that contains one or many csv files\n    tsvz\ta zip file that contains one or many tsv files\n    xls\t    a spreadsheet file format created by MS-Excel 97-2003\n    xlsx\tMS-Excel Extensions to the Office Open XML SpreadsheetML File Format.\n    xlsm\tan MS-Excel Macro-Enabled Workbook file\n    ods\t    open document spreadsheet\n    fods\tflat open document spreadsheet\n    json\tjava script object notation\n    html\thtml table of the data structure\n    simple\tsimple presentation\n    rst\t    rStructured Text presentation of the data\n    mediawiki\tmedia wiki table\n    \"\"\"\n    if isinstance(path, str):\n        path = Path(path)\n    if not isinstance(path, Path):\n        raise TypeError(\"expected pathlib path.\")\n    if not path.exists():\n        raise FileNotFoundError(str(path))\n    if delimiter is not None:\n        if not isinstance(delimiter, str):\n            raise TypeError(f\"expected str or None, not {type(delimiter)}\")\n\n    kwargs = {\n        \"path\": path,\n        \"delimiter\": delimiter,\n        \"header_row_index\": header_row_index,\n        \"text_qualifier\": text_qualifier,\n        \"linecount\": linecount\n   }\n\n    reader = header_readers.get(path.suffix[1:], None)\n\n    if reader is None:\n        raise TypeError(f\"file format for headers not supported: {path.suffix}\")\n\n    result = reader(**kwargs)\n\n    return result\n</code></pre>"},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.get_encoding","title":"<code>tablite.file_reader_utils.get_encoding(path, nbytes=ENCODING_GUESS_BYTES)</code>","text":"Source code in <code>tablite/file_reader_utils.py</code> <pre><code>def get_encoding(path, nbytes=ENCODING_GUESS_BYTES):\n    nbytes = min(nbytes, path.stat().st_size)\n    with path.open(\"rb\") as fi:\n        rawdata = fi.read(nbytes)\n        encoding = chardet.detect(rawdata)[\"encoding\"]\n        if encoding == \"ascii\":  # utf-8 is backwards compatible with ascii\n            return \"utf-8\"  # --   so should the first 10k chars not be enough,\n        return encoding  # --      the utf-8 encoding will still get it right.\n</code></pre>"},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.get_delimiter","title":"<code>tablite.file_reader_utils.get_delimiter(path, encoding)</code>","text":"Source code in <code>tablite/file_reader_utils.py</code> <pre><code>def get_delimiter(path, encoding):\n    with path.open(\"r\", encoding=encoding, errors=\"ignore\") as fi:\n        lines = []\n        for n, line in enumerate(fi):\n            line = line.rstrip(\"\\n\")\n            lines.append(line)\n            if n &gt; 10:\n                break  # break on first\n        delimiter = detect_seperator(\"\\n\".join(lines))\n        if delimiter is None:\n            raise ValueError(\"Delimiter could not be determined\")\n        return delimiter\n</code></pre>"},{"location":"reference/groupby_utils/","title":"Groupby utils","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils","title":"<code>tablite.groupby_utils</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils-classes","title":"Classes","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupbyFunction","title":"<code>tablite.groupby_utils.GroupbyFunction</code>","text":"<p>             Bases: <code>object</code></p>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.Limit","title":"<code>tablite.groupby_utils.Limit()</code>","text":"<p>             Bases: <code>GroupbyFunction</code></p> Source code in <code>tablite/groupby_utils.py</code> <pre><code>def __init__(self):\n    self.value = None\n    self.f = None\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.Limit-attributes","title":"Attributes","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Limit.value","title":"<code>tablite.groupby_utils.Limit.value = None</code>  <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Limit.f","title":"<code>tablite.groupby_utils.Limit.f = None</code>  <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Limit-functions","title":"Functions","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Limit.update","title":"<code>tablite.groupby_utils.Limit.update(value)</code>","text":"Source code in <code>tablite/groupby_utils.py</code> <pre><code>def update(self, value):\n    if value is None:\n        pass\n    elif self.value is None:\n        self.value = value\n    else:\n        self.value = self.f((value, self.value))\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.Max","title":"<code>tablite.groupby_utils.Max()</code>","text":"<p>             Bases: <code>Limit</code></p> Source code in <code>tablite/groupby_utils.py</code> <pre><code>def __init__(self):\n    super().__init__()\n    self.f = max\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.Max-attributes","title":"Attributes","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Max.value","title":"<code>tablite.groupby_utils.Max.value = None</code>  <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Max.f","title":"<code>tablite.groupby_utils.Max.f = max</code>  <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Max-functions","title":"Functions","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Max.update","title":"<code>tablite.groupby_utils.Max.update(value)</code>","text":"Source code in <code>tablite/groupby_utils.py</code> <pre><code>def update(self, value):\n    if value is None:\n        pass\n    elif self.value is None:\n        self.value = value\n    else:\n        self.value = self.f((value, self.value))\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.Min","title":"<code>tablite.groupby_utils.Min()</code>","text":"<p>             Bases: <code>Limit</code></p> Source code in <code>tablite/groupby_utils.py</code> <pre><code>def __init__(self):\n    super().__init__()\n    self.f = min\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.Min-attributes","title":"Attributes","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Min.value","title":"<code>tablite.groupby_utils.Min.value = None</code>  <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Min.f","title":"<code>tablite.groupby_utils.Min.f = min</code>  <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Min-functions","title":"Functions","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Min.update","title":"<code>tablite.groupby_utils.Min.update(value)</code>","text":"Source code in <code>tablite/groupby_utils.py</code> <pre><code>def update(self, value):\n    if value is None:\n        pass\n    elif self.value is None:\n        self.value = value\n    else:\n        self.value = self.f((value, self.value))\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.Sum","title":"<code>tablite.groupby_utils.Sum()</code>","text":"<p>             Bases: <code>GroupbyFunction</code></p> Source code in <code>tablite/groupby_utils.py</code> <pre><code>def __init__(self):\n    self.value = 0\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.Sum-attributes","title":"Attributes","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Sum.value","title":"<code>tablite.groupby_utils.Sum.value = 0</code>  <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Sum-functions","title":"Functions","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Sum.update","title":"<code>tablite.groupby_utils.Sum.update(value)</code>","text":"Source code in <code>tablite/groupby_utils.py</code> <pre><code>def update(self, value):\n    if isinstance(value, (type(None), date, time, datetime, str)):\n        raise ValueError(f\"Sum of {type(value)} doesn't make sense.\")\n    self.value += value\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.Product","title":"<code>tablite.groupby_utils.Product()</code>","text":"<p>             Bases: <code>GroupbyFunction</code></p> Source code in <code>tablite/groupby_utils.py</code> <pre><code>def __init__(self) -&gt; None:\n    self.value = 1\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.Product-attributes","title":"Attributes","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Product.value","title":"<code>tablite.groupby_utils.Product.value = 1</code>  <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Product-functions","title":"Functions","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Product.update","title":"<code>tablite.groupby_utils.Product.update(value)</code>","text":"Source code in <code>tablite/groupby_utils.py</code> <pre><code>def update(self, value):\n    self.value *= value\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.First","title":"<code>tablite.groupby_utils.First()</code>","text":"<p>             Bases: <code>GroupbyFunction</code></p> Source code in <code>tablite/groupby_utils.py</code> <pre><code>def __init__(self):\n    self.value = self.empty\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.First-attributes","title":"Attributes","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.First.empty","title":"<code>tablite.groupby_utils.First.empty = (None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.First.value","title":"<code>tablite.groupby_utils.First.value = self.empty</code>  <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.First-functions","title":"Functions","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.First.update","title":"<code>tablite.groupby_utils.First.update(value)</code>","text":"Source code in <code>tablite/groupby_utils.py</code> <pre><code>def update(self, value):\n    if self.value is First.empty:\n        self.value = value\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.Last","title":"<code>tablite.groupby_utils.Last()</code>","text":"<p>             Bases: <code>GroupbyFunction</code></p> Source code in <code>tablite/groupby_utils.py</code> <pre><code>def __init__(self):\n    self.value = None\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.Last-attributes","title":"Attributes","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Last.value","title":"<code>tablite.groupby_utils.Last.value = None</code>  <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Last-functions","title":"Functions","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Last.update","title":"<code>tablite.groupby_utils.Last.update(value)</code>","text":"Source code in <code>tablite/groupby_utils.py</code> <pre><code>def update(self, value):\n    self.value = value\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.Count","title":"<code>tablite.groupby_utils.Count()</code>","text":"<p>             Bases: <code>GroupbyFunction</code></p> Source code in <code>tablite/groupby_utils.py</code> <pre><code>def __init__(self):\n    self.value = 0\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.Count-attributes","title":"Attributes","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Count.value","title":"<code>tablite.groupby_utils.Count.value = 0</code>  <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Count-functions","title":"Functions","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Count.update","title":"<code>tablite.groupby_utils.Count.update(value)</code>","text":"Source code in <code>tablite/groupby_utils.py</code> <pre><code>def update(self, value):\n    self.value += 1\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.CountUnique","title":"<code>tablite.groupby_utils.CountUnique()</code>","text":"<p>             Bases: <code>GroupbyFunction</code></p> Source code in <code>tablite/groupby_utils.py</code> <pre><code>def __init__(self):\n    self.items = set()\n    self.value = None\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.CountUnique-attributes","title":"Attributes","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.CountUnique.items","title":"<code>tablite.groupby_utils.CountUnique.items = set()</code>  <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.CountUnique.value","title":"<code>tablite.groupby_utils.CountUnique.value = None</code>  <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.CountUnique-functions","title":"Functions","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.CountUnique.update","title":"<code>tablite.groupby_utils.CountUnique.update(value)</code>","text":"Source code in <code>tablite/groupby_utils.py</code> <pre><code>def update(self, value):\n    self.items.add(value)\n    self.value = len(self.items)\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.Average","title":"<code>tablite.groupby_utils.Average()</code>","text":"<p>             Bases: <code>GroupbyFunction</code></p> Source code in <code>tablite/groupby_utils.py</code> <pre><code>def __init__(self):\n    self.sum = 0\n    self.count = 0\n    self.value = 0\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.Average-attributes","title":"Attributes","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Average.sum","title":"<code>tablite.groupby_utils.Average.sum = 0</code>  <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Average.count","title":"<code>tablite.groupby_utils.Average.count = 0</code>  <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Average.value","title":"<code>tablite.groupby_utils.Average.value = 0</code>  <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Average-functions","title":"Functions","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Average.update","title":"<code>tablite.groupby_utils.Average.update(value)</code>","text":"Source code in <code>tablite/groupby_utils.py</code> <pre><code>def update(self, value):\n    if isinstance(value, (date, time, datetime, str)):\n        raise ValueError(f\"Sum of {type(value)} doesn't make sense.\")\n    if value is not None:\n        self.sum += value\n        self.count += 1\n        self.value = self.sum / self.count\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.StandardDeviation","title":"<code>tablite.groupby_utils.StandardDeviation()</code>","text":"<p>             Bases: <code>GroupbyFunction</code></p> <p>Uses J.P. Welfords (1962) algorithm. For details see https://en.wikipedia.org/wiki/Algorithms_for_calculating_variance#Online_algorithm</p> Source code in <code>tablite/groupby_utils.py</code> <pre><code>def __init__(self):\n    self.count = 0\n    self.mean = 0\n    self.c = 0.0\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.StandardDeviation-attributes","title":"Attributes","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.StandardDeviation.count","title":"<code>tablite.groupby_utils.StandardDeviation.count = 0</code>  <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.StandardDeviation.mean","title":"<code>tablite.groupby_utils.StandardDeviation.mean = 0</code>  <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.StandardDeviation.c","title":"<code>tablite.groupby_utils.StandardDeviation.c = 0.0</code>  <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.StandardDeviation.value","title":"<code>tablite.groupby_utils.StandardDeviation.value</code>  <code>property</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.StandardDeviation-functions","title":"Functions","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.StandardDeviation.update","title":"<code>tablite.groupby_utils.StandardDeviation.update(value)</code>","text":"Source code in <code>tablite/groupby_utils.py</code> <pre><code>def update(self, value):\n    if isinstance(value, (date, time, datetime, str)):\n        raise ValueError(f\"Std.dev. of {type(value)} doesn't make sense.\")\n    if value is not None:\n        self.count += 1\n        dt = value - self.mean\n        self.mean += dt / self.count\n        self.c += dt * (value - self.mean)\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.Histogram","title":"<code>tablite.groupby_utils.Histogram()</code>","text":"<p>             Bases: <code>GroupbyFunction</code></p> Source code in <code>tablite/groupby_utils.py</code> <pre><code>def __init__(self):\n    self.hist = defaultdict(int)\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.Histogram-attributes","title":"Attributes","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Histogram.hist","title":"<code>tablite.groupby_utils.Histogram.hist = defaultdict(int)</code>  <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Histogram-functions","title":"Functions","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Histogram.update","title":"<code>tablite.groupby_utils.Histogram.update(value)</code>","text":"Source code in <code>tablite/groupby_utils.py</code> <pre><code>def update(self, value):\n    self.hist[value] += 1\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.Median","title":"<code>tablite.groupby_utils.Median()</code>","text":"<p>             Bases: <code>Histogram</code></p> Source code in <code>tablite/groupby_utils.py</code> <pre><code>def __init__(self):\n    super().__init__()\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.Median-attributes","title":"Attributes","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Median.hist","title":"<code>tablite.groupby_utils.Median.hist = defaultdict(int)</code>  <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Median.value","title":"<code>tablite.groupby_utils.Median.value</code>  <code>property</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Median-functions","title":"Functions","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Median.update","title":"<code>tablite.groupby_utils.Median.update(value)</code>","text":"Source code in <code>tablite/groupby_utils.py</code> <pre><code>def update(self, value):\n    self.hist[value] += 1\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.Mode","title":"<code>tablite.groupby_utils.Mode()</code>","text":"<p>             Bases: <code>Histogram</code></p> Source code in <code>tablite/groupby_utils.py</code> <pre><code>def __init__(self):\n    super().__init__()\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.Mode-attributes","title":"Attributes","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Mode.hist","title":"<code>tablite.groupby_utils.Mode.hist = defaultdict(int)</code>  <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Mode.value","title":"<code>tablite.groupby_utils.Mode.value</code>  <code>property</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Mode-functions","title":"Functions","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.Mode.update","title":"<code>tablite.groupby_utils.Mode.update(value)</code>","text":"Source code in <code>tablite/groupby_utils.py</code> <pre><code>def update(self, value):\n    self.hist[value] += 1\n</code></pre>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy","title":"<code>tablite.groupby_utils.GroupBy</code>","text":"<p>             Bases: <code>object</code></p>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy-attributes","title":"Attributes","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.max","title":"<code>tablite.groupby_utils.GroupBy.max = Max</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.min","title":"<code>tablite.groupby_utils.GroupBy.min = Min</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.sum","title":"<code>tablite.groupby_utils.GroupBy.sum = Sum</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.product","title":"<code>tablite.groupby_utils.GroupBy.product = Product</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.first","title":"<code>tablite.groupby_utils.GroupBy.first = First</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.last","title":"<code>tablite.groupby_utils.GroupBy.last = Last</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.count","title":"<code>tablite.groupby_utils.GroupBy.count = Count</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.count_unique","title":"<code>tablite.groupby_utils.GroupBy.count_unique = CountUnique</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.avg","title":"<code>tablite.groupby_utils.GroupBy.avg = Average</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.stdev","title":"<code>tablite.groupby_utils.GroupBy.stdev = StandardDeviation</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.median","title":"<code>tablite.groupby_utils.GroupBy.median = Median</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.mode","title":"<code>tablite.groupby_utils.GroupBy.mode = Mode</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.functions","title":"<code>tablite.groupby_utils.GroupBy.functions = [Max, Min, Sum, First, Last, Product, Count, CountUnique, Average, StandardDeviation, Median, Mode]</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.function_names","title":"<code>tablite.groupby_utils.GroupBy.function_names = {f.__name__: ffor f in functions}</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupbys/","title":"Groupbys","text":""},{"location":"reference/groupbys/#tablite.groupbys","title":"<code>tablite.groupbys</code>","text":""},{"location":"reference/groupbys/#tablite.groupbys-classes","title":"Classes","text":""},{"location":"reference/groupbys/#tablite.groupbys-functions","title":"Functions","text":""},{"location":"reference/groupbys/#tablite.groupbys.groupby","title":"<code>tablite.groupbys.groupby(T, keys, functions, tqdm=_tqdm, pbar=None)</code>","text":"<p>keys: column names for grouping. functions: [optional] list of column names and group functions (See GroupyBy class) returns: table</p> <p>Example:</p> <pre><code>&gt;&gt;&gt; t = Table()\n&gt;&gt;&gt; t.add_column('A', data=[1, 1, 2, 2, 3, 3] * 2)\n&gt;&gt;&gt; t.add_column('B', data=[1, 2, 3, 4, 5, 6] * 2)\n&gt;&gt;&gt; t.add_column('C', data=[6, 5, 4, 3, 2, 1] * 2)\n&gt;&gt;&gt; t.show()\n+=====+=====+=====+\n|  A  |  B  |  C  |\n| int | int | int |\n+-----+-----+-----+\n|    1|    1|    6|\n|    1|    2|    5|\n|    2|    3|    4|\n|    2|    4|    3|\n|    3|    5|    2|\n|    3|    6|    1|\n|    1|    1|    6|\n|    1|    2|    5|\n|    2|    3|    4|\n|    2|    4|    3|\n|    3|    5|    2|\n|    3|    6|    1|\n+=====+=====+=====+\n&gt;&gt;&gt; g = t.groupby(keys=['A', 'C'], functions=[('B', gb.sum)])\n&gt;&gt;&gt; g.show()\n+===+===+===+======+\n| # | A | C |Sum(B)|\n|row|int|int| int  |\n+---+---+---+------+\n|0  |  1|  6|     2|\n|1  |  1|  5|     4|\n|2  |  2|  4|     6|\n|3  |  2|  3|     8|\n|4  |  3|  2|    10|\n|5  |  3|  1|    12|\n+===+===+===+======+\n</code></pre> <p>Cheat sheet:</p> <p>list of unique values</p> <pre><code>&gt;&gt;&gt; g1 = t.groupby(keys=['A'], functions=[])\n&gt;&gt;&gt; g1['A'][:]\n[1,2,3]\n</code></pre> <p>alternatively:</p> <pre><code>&gt;&gt;&gt; t['A'].unique()\n[1,2,3]\n</code></pre> <p>list of unique values, grouped by longest combination.</p> <pre><code>&gt;&gt;&gt; g2 = t.groupby(keys=['A', 'B'], functions=[])\n&gt;&gt;&gt; g2['A'][:], g2['B'][:]\n([1,1,2,2,3,3], [1,2,3,4,5,6])\n</code></pre> <p>alternatively use:</p> <pre><code>&gt;&gt;&gt; list(zip(*t.index('A', 'B').keys()))\n[(1,1,2,2,3,3) (1,2,3,4,5,6)]\n</code></pre> <p>A key (unique values) and count hereof.</p> <pre><code>&gt;&gt;&gt; g3 = t.groupby(keys=['A'], functions=[('A', gb.count)])\n&gt;&gt;&gt; g3['A'][:], g3['Count(A)'][:]\n([1,2,3], [4,4,4])\n</code></pre> <p>alternatively use:</p> <pre><code>&gt;&gt;&gt; t['A'].histogram()\n([1,2,3], [4,4,4])\n</code></pre> <p>for more examples see: https://github.com/root-11/tablite/blob/master/tests/test_groupby.py</p> Source code in <code>tablite/groupbys.py</code> <pre><code>def groupby(\n    T, keys, functions, tqdm=_tqdm, pbar=None\n):  # TODO: This is single core code.\n    \"\"\"\n    keys: column names for grouping.\n    functions: [optional] list of column names and group functions (See GroupyBy class)\n    returns: table\n\n    Example:\n    ```\n    &gt;&gt;&gt; t = Table()\n    &gt;&gt;&gt; t.add_column('A', data=[1, 1, 2, 2, 3, 3] * 2)\n    &gt;&gt;&gt; t.add_column('B', data=[1, 2, 3, 4, 5, 6] * 2)\n    &gt;&gt;&gt; t.add_column('C', data=[6, 5, 4, 3, 2, 1] * 2)\n    &gt;&gt;&gt; t.show()\n    +=====+=====+=====+\n    |  A  |  B  |  C  |\n    | int | int | int |\n    +-----+-----+-----+\n    |    1|    1|    6|\n    |    1|    2|    5|\n    |    2|    3|    4|\n    |    2|    4|    3|\n    |    3|    5|    2|\n    |    3|    6|    1|\n    |    1|    1|    6|\n    |    1|    2|    5|\n    |    2|    3|    4|\n    |    2|    4|    3|\n    |    3|    5|    2|\n    |    3|    6|    1|\n    +=====+=====+=====+\n    &gt;&gt;&gt; g = t.groupby(keys=['A', 'C'], functions=[('B', gb.sum)])\n    &gt;&gt;&gt; g.show()\n    +===+===+===+======+\n    | # | A | C |Sum(B)|\n    |row|int|int| int  |\n    +---+---+---+------+\n    |0  |  1|  6|     2|\n    |1  |  1|  5|     4|\n    |2  |  2|  4|     6|\n    |3  |  2|  3|     8|\n    |4  |  3|  2|    10|\n    |5  |  3|  1|    12|\n    +===+===+===+======+\n    ```\n\n    Cheat sheet:\n\n    list of unique values\n    ```\n    &gt;&gt;&gt; g1 = t.groupby(keys=['A'], functions=[])\n    &gt;&gt;&gt; g1['A'][:]\n    [1,2,3]\n    ```\n    alternatively:\n    ```\n    &gt;&gt;&gt; t['A'].unique()\n    [1,2,3]\n    ```\n    list of unique values, grouped by longest combination.\n    ```\n    &gt;&gt;&gt; g2 = t.groupby(keys=['A', 'B'], functions=[])\n    &gt;&gt;&gt; g2['A'][:], g2['B'][:]\n    ([1,1,2,2,3,3], [1,2,3,4,5,6])\n    ```\n    alternatively use:\n    ```\n    &gt;&gt;&gt; list(zip(*t.index('A', 'B').keys()))\n    [(1,1,2,2,3,3) (1,2,3,4,5,6)]\n    ```\n\n    A key (unique values) and count hereof.\n    ```\n    &gt;&gt;&gt; g3 = t.groupby(keys=['A'], functions=[('A', gb.count)])\n    &gt;&gt;&gt; g3['A'][:], g3['Count(A)'][:]\n    ([1,2,3], [4,4,4])\n    ```\n    alternatively use:\n    ```\n    &gt;&gt;&gt; t['A'].histogram()\n    ([1,2,3], [4,4,4])\n    ```\n    for more examples see: https://github.com/root-11/tablite/blob/master/tests/test_groupby.py\n\n    \"\"\"\n    if not isinstance(keys, list):\n        raise TypeError(\"expected keys as a list of column names\")\n\n    if keys:\n        if len(set(keys)) != len(keys):\n            duplicates = [k for k in keys if keys.count(k) &gt; 1]\n            s = \"\" if len(duplicates) &gt; 1 else \"s\"\n            raise ValueError(\n                f\"duplicate key{s} found across rows and columns: {duplicates}\"\n            )\n\n    if not isinstance(functions, list):\n        raise TypeError(\n            f\"Expected functions to be a list of tuples. Got {type(functions)}\"\n        )\n\n    if not keys + functions:\n        raise ValueError(\"No keys or functions?\")\n\n    if not all(len(i) == 2 for i in functions):\n        raise ValueError(\n            f\"Expected each tuple in functions to be of length 2. \\nGot {functions}\"\n        )\n\n    if not all(isinstance(a, str) for a, _ in functions):\n        L = [(a, type(a)) for a, _ in functions if not isinstance(a, str)]\n        raise ValueError(\n            f\"Expected column names in functions to be strings. Found: {L}\"\n        )\n\n    if not all(\n        issubclass(b, GroupbyFunction) and b in GroupBy.functions for _, b in functions\n    ):\n        L = [b for _, b in functions if b not in GroupBy._functions]\n        if len(L) == 1:\n            singular = f\"function {L[0]} is not in GroupBy.functions\"\n            raise ValueError(singular)\n        else:\n            plural = f\"the functions {L} are not in GroupBy.functions\"\n            raise ValueError(plural)\n\n    # only keys will produce unique values for each key group.\n    if keys and not functions:\n        cols = list(zip(*T.index(*keys)))\n        result = T.__class__()\n\n        pbar = tqdm(total=len(keys), desc=\"groupby\") if pbar is None else pbar\n\n        for col_name, col in zip(keys, cols):\n            result[col_name] = col\n\n            pbar.update(1)\n        return result\n\n    # grouping is required...\n    # 1. Aggregate data.\n    aggregation_functions = defaultdict(dict)\n    cols = keys + [col_name for col_name, _ in functions]\n    seen, L = set(), []\n    for c in cols:  # maintains order of appearance.\n        if c not in seen:\n            seen.add(c)\n            L.append(c)\n\n    # there's a table of values.\n    data = T[L]\n    if isinstance(data, Column):\n        tbl = BaseTable()\n        tbl[L[0]] = data\n    else:\n        tbl = data\n\n    pbar = (\n        tqdm(desc=\"groupby\", total=len(tbl), disable=Config.TQDM_DISABLE)\n        if pbar is None\n        else pbar\n    )\n\n    for row in tbl.rows:\n        d = {col_name: value for col_name, value in zip(L, row)}\n        key = tuple([d[k] for k in keys])\n        agg_functions = aggregation_functions.get(key)\n        if not agg_functions:\n            aggregation_functions[key] = agg_functions = [\n                (col_name, f()) for col_name, f in functions\n            ]\n        for col_name, f in agg_functions:\n            f.update(d[col_name])\n\n        pbar.update(1)\n\n    # 2. make dense table.\n    cols = [[] for _ in cols]\n    for key_tuple, funcs in aggregation_functions.items():\n        for ix, key_value in enumerate(key_tuple):\n            cols[ix].append(key_value)\n        for ix, (_, f) in enumerate(funcs, start=len(keys)):\n            cols[ix].append(f.value)\n\n    new_names = keys + [f\"{f.__name__}({col_name})\" for col_name, f in functions]\n    result = type(T)()  # New Table.\n    for ix, (col_name, data) in enumerate(zip(new_names, cols)):\n        revised_name = unique_name(col_name, result.columns)\n        result[revised_name] = data\n    return result\n</code></pre>"},{"location":"reference/import_utils/","title":"Import utils","text":""},{"location":"reference/import_utils/#tablite.import_utils","title":"<code>tablite.import_utils</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils-attributes","title":"Attributes","text":""},{"location":"reference/import_utils/#tablite.import_utils.file_readers","title":"<code>tablite.import_utils.file_readers = {'fods': excel_reader, 'json': excel_reader, 'html': from_html, 'hdf5': from_hdf5, 'simple': excel_reader, 'rst': excel_reader, 'mediawiki': excel_reader, 'xlsx': excel_reader, 'xls': excel_reader, 'xlsm': excel_reader, 'csv': text_reader, 'tsv': text_reader, 'txt': text_reader, 'ods': ods_reader}</code>  <code>module-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.valid_readers","title":"<code>tablite.import_utils.valid_readers = ','.join(list(file_readers.keys()))</code>  <code>module-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils-classes","title":"Classes","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig","title":"<code>tablite.import_utils.TRconfig(source, destination, start, end, guess_datatypes, delimiter, text_qualifier, text_escape_openings, text_escape_closures, strip_leading_and_tailing_whitespace, encoding, newline_offsets, fields)</code>","text":"<p>             Bases: <code>object</code></p> Source code in <code>tablite/import_utils.py</code> <pre><code>def __init__(\n    self,\n    source,\n    destination,\n    start,\n    end,\n    guess_datatypes,\n    delimiter,\n    text_qualifier,\n    text_escape_openings,\n    text_escape_closures,\n    strip_leading_and_tailing_whitespace,\n    encoding,\n    newline_offsets,\n    fields\n) -&gt; None:\n    self.source = source\n    self.destination = destination\n    self.start = start\n    self.end = end\n    self.guess_datatypes = guess_datatypes\n    self.delimiter = delimiter\n    self.text_qualifier = text_qualifier\n    self.text_escape_openings = text_escape_openings\n    self.text_escape_closures = text_escape_closures\n    self.strip_leading_and_tailing_whitespace = strip_leading_and_tailing_whitespace\n    self.encoding = encoding\n    self.newline_offsets = newline_offsets\n    self.fields = fields\n    type_check(start, int),\n    type_check(end, int),\n    type_check(delimiter, str),\n    type_check(text_qualifier, (str, type(None))),\n    type_check(text_escape_openings, str),\n    type_check(text_escape_closures, str),\n    type_check(encoding, str),\n    type_check(strip_leading_and_tailing_whitespace, bool),\n    type_check(newline_offsets, list)\n    type_check(fields, dict)\n</code></pre>"},{"location":"reference/import_utils/#tablite.import_utils.TRconfig-attributes","title":"Attributes","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.source","title":"<code>tablite.import_utils.TRconfig.source = source</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.destination","title":"<code>tablite.import_utils.TRconfig.destination = destination</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.start","title":"<code>tablite.import_utils.TRconfig.start = start</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.end","title":"<code>tablite.import_utils.TRconfig.end = end</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.guess_datatypes","title":"<code>tablite.import_utils.TRconfig.guess_datatypes = guess_datatypes</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.delimiter","title":"<code>tablite.import_utils.TRconfig.delimiter = delimiter</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.text_qualifier","title":"<code>tablite.import_utils.TRconfig.text_qualifier = text_qualifier</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.text_escape_openings","title":"<code>tablite.import_utils.TRconfig.text_escape_openings = text_escape_openings</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.text_escape_closures","title":"<code>tablite.import_utils.TRconfig.text_escape_closures = text_escape_closures</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.strip_leading_and_tailing_whitespace","title":"<code>tablite.import_utils.TRconfig.strip_leading_and_tailing_whitespace = strip_leading_and_tailing_whitespace</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.encoding","title":"<code>tablite.import_utils.TRconfig.encoding = encoding</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.newline_offsets","title":"<code>tablite.import_utils.TRconfig.newline_offsets = newline_offsets</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.fields","title":"<code>tablite.import_utils.TRconfig.fields = fields</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig-functions","title":"Functions","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.copy","title":"<code>tablite.import_utils.TRconfig.copy()</code>","text":"Source code in <code>tablite/import_utils.py</code> <pre><code>def copy(self):\n    return TRconfig(**self.dict())\n</code></pre>"},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.dict","title":"<code>tablite.import_utils.TRconfig.dict()</code>","text":"Source code in <code>tablite/import_utils.py</code> <pre><code>def dict(self):\n    return {k: v for k, v in self.__dict__.items() if not (k.startswith(\"_\") or callable(v))}\n</code></pre>"},{"location":"reference/import_utils/#tablite.import_utils-functions","title":"Functions","text":""},{"location":"reference/import_utils/#tablite.import_utils.from_pandas","title":"<code>tablite.import_utils.from_pandas(T, df)</code>","text":"<p>Creates Table using pd.to_dict('list')</p> <p>similar to:</p> <p>import pandas as pd df = pd.DataFrame({'a':[1,2,3], 'b':[4,5,6]}) df     a  b     0  1  4     1  2  5     2  3  6 df.to_dict('list')</p> <p>t = Table.from_dict(df.to_dict('list)) t.show()     +===+===+===+     | # | a | b |     |row|int|int|     +---+---+---+     | 0 |  1|  4|     | 1 |  2|  5|     | 2 |  3|  6|     +===+===+===+</p> Source code in <code>tablite/import_utils.py</code> <pre><code>def from_pandas(T, df):\n    \"\"\"\n    Creates Table using pd.to_dict('list')\n\n    similar to:\n    &gt;&gt;&gt; import pandas as pd\n    &gt;&gt;&gt; df = pd.DataFrame({'a':[1,2,3], 'b':[4,5,6]})\n    &gt;&gt;&gt; df\n        a  b\n        0  1  4\n        1  2  5\n        2  3  6\n    &gt;&gt;&gt; df.to_dict('list')\n    {'a': [1, 2, 3], 'b': [4, 5, 6]}\n\n    &gt;&gt;&gt; t = Table.from_dict(df.to_dict('list))\n    &gt;&gt;&gt; t.show()\n        +===+===+===+\n        | # | a | b |\n        |row|int|int|\n        +---+---+---+\n        | 0 |  1|  4|\n        | 1 |  2|  5|\n        | 2 |  3|  6|\n        +===+===+===+\n    \"\"\"\n    if not issubclass(T, BaseTable):\n        raise TypeError(\"Expected subclass of Table\")\n\n    return T(columns=df.to_dict(\"list\"))  # noqa\n</code></pre>"},{"location":"reference/import_utils/#tablite.import_utils.from_hdf5","title":"<code>tablite.import_utils.from_hdf5(T, path, tqdm=_tqdm, pbar=None)</code>","text":"<p>imports an exported hdf5 table.</p> <p>Note that some loss of type information is to be expected in columns of mixed type:</p> <p>t.show(dtype=True) +===+===+=====+=====+====+=====+=====+===================+==========+========+===============+===+=========================+=====+===+ | # | A |  B  |  C  | D  |  E  |  F  |         G         |    H     |   I    |       J       | K |            L            |  M  | O | |row|int|mixed|float|str |mixed| bool|      datetime     |   date   |  time  |   timedelta   |str|           int           |float|int| +---+---+-----+-----+----+-----+-----+-------------------+----------+--------+---------------+---+-------------------------+-----+---+ | 0 | -1|None | -1.1|    |None |False|2023-06-09 09:12:06|2023-06-09|09:12:06| 1 day, 0:00:00|b  |-100000000000000000000000|  inf| 11| | 1 |  1|    1|  1.1|1000|1    | True|2023-06-09 09:12:06|2023-06-09|09:12:06|2 days, 0:06:40|\u55e8 | 100000000000000000000000| -inf|-11| +===+===+=====+=====+====+=====+=====+===================+==========+========+===============+===+=========================+=====+===+ t.to_hdf5(filename) t2 = Table.from_hdf5(filename) t2.show(dtype=True) +===+===+=====+=====+=====+=====+=====+===================+===================+========+===============+===+=========================+=====+===+ | # | A |  B  |  C  |  D  |  E  |  F  |         G         |         H         |   I    |       J       | K |            L            |  M  | O | |row|int|mixed|float|mixed|mixed| bool|      datetime     |      datetime     |  time  |      str      |str|           int           |float|int| +---+---+-----+-----+-----+-----+-----+-------------------+-------------------+--------+---------------+---+-------------------------+-----+---+ | 0 | -1|None | -1.1|None |None |False|2023-06-09 09:12:06|2023-06-09 00:00:00|09:12:06|1 day, 0:00:00 |b  |-100000000000000000000000|  inf| 11| | 1 |  1|    1|  1.1| 1000|    1| True|2023-06-09 09:12:06|2023-06-09 00:00:00|09:12:06|2 days, 0:06:40|\u55e8 | 100000000000000000000000| -inf|-11| +===+===+=====+=====+=====+=====+=====+===================+===================+========+===============+===+=========================+=====+===+</p> Source code in <code>tablite/import_utils.py</code> <pre><code>def from_hdf5(T, path, tqdm=_tqdm, pbar=None):\n    \"\"\"\n    imports an exported hdf5 table.\n\n    Note that some loss of type information is to be expected in columns of mixed type:\n    &gt;&gt;&gt; t.show(dtype=True)\n    +===+===+=====+=====+====+=====+=====+===================+==========+========+===============+===+=========================+=====+===+\n    | # | A |  B  |  C  | D  |  E  |  F  |         G         |    H     |   I    |       J       | K |            L            |  M  | O |\n    |row|int|mixed|float|str |mixed| bool|      datetime     |   date   |  time  |   timedelta   |str|           int           |float|int|\n    +---+---+-----+-----+----+-----+-----+-------------------+----------+--------+---------------+---+-------------------------+-----+---+\n    | 0 | -1|None | -1.1|    |None |False|2023-06-09 09:12:06|2023-06-09|09:12:06| 1 day, 0:00:00|b  |-100000000000000000000000|  inf| 11|\n    | 1 |  1|    1|  1.1|1000|1    | True|2023-06-09 09:12:06|2023-06-09|09:12:06|2 days, 0:06:40|\u55e8 | 100000000000000000000000| -inf|-11|\n    +===+===+=====+=====+====+=====+=====+===================+==========+========+===============+===+=========================+=====+===+\n    &gt;&gt;&gt; t.to_hdf5(filename)\n    &gt;&gt;&gt; t2 = Table.from_hdf5(filename)\n    &gt;&gt;&gt; t2.show(dtype=True)\n    +===+===+=====+=====+=====+=====+=====+===================+===================+========+===============+===+=========================+=====+===+\n    | # | A |  B  |  C  |  D  |  E  |  F  |         G         |         H         |   I    |       J       | K |            L            |  M  | O |\n    |row|int|mixed|float|mixed|mixed| bool|      datetime     |      datetime     |  time  |      str      |str|           int           |float|int|\n    +---+---+-----+-----+-----+-----+-----+-------------------+-------------------+--------+---------------+---+-------------------------+-----+---+\n    | 0 | -1|None | -1.1|None |None |False|2023-06-09 09:12:06|2023-06-09 00:00:00|09:12:06|1 day, 0:00:00 |b  |-100000000000000000000000|  inf| 11|\n    | 1 |  1|    1|  1.1| 1000|    1| True|2023-06-09 09:12:06|2023-06-09 00:00:00|09:12:06|2 days, 0:06:40|\u55e8 | 100000000000000000000000| -inf|-11|\n    +===+===+=====+=====+=====+=====+=====+===================+===================+========+===============+===+=========================+=====+===+\n    \"\"\"\n    if not issubclass(T, BaseTable):\n        raise TypeError(\"Expected subclass of Table\")\n    import h5py\n\n    type_check(path, Path)\n    t = T()\n    with h5py.File(path, \"r\") as h5:\n        for col_name in h5.keys():\n            dset = h5[col_name]\n            arr = np.array(dset[:])\n            if arr.dtype == object:\n                arr = np.array(DataTypes.guess([v.decode(\"utf-8\") for v in arr]))\n            t[col_name] = arr\n    return t\n</code></pre>"},{"location":"reference/import_utils/#tablite.import_utils.from_json","title":"<code>tablite.import_utils.from_json(T, jsn)</code>","text":"<p>Imports tables exported using .to_json</p> Source code in <code>tablite/import_utils.py</code> <pre><code>def from_json(T, jsn):\n    \"\"\"\n    Imports tables exported using .to_json\n    \"\"\"\n    if not issubclass(T, BaseTable):\n        raise TypeError(\"Expected subclass of Table\")\n    import json\n\n    type_check(jsn, str)\n    d = json.loads(jsn)\n    return T(columns=d[\"columns\"])\n</code></pre>"},{"location":"reference/import_utils/#tablite.import_utils.from_html","title":"<code>tablite.import_utils.from_html(T, path, tqdm=_tqdm, pbar=None)</code>","text":"Source code in <code>tablite/import_utils.py</code> <pre><code>def from_html(T, path, tqdm=_tqdm, pbar=None):\n    if not issubclass(T, BaseTable):\n        raise TypeError(\"Expected subclass of Table\")\n    type_check(path, Path)\n\n    if pbar is None:\n        total = path.stat().st_size\n        pbar = tqdm(total=total, desc=\"from_html\", disable=Config.TQDM_DISABLE)\n\n    row_start, row_end = \"&lt;tr&gt;\", \"&lt;/tr&gt;\"\n    value_start, value_end = \"&lt;th&gt;\", \"&lt;/th&gt;\"\n    chunk = \"\"\n    t = None  # will be T()\n    start, end = 0, 0\n    data = {}\n    with path.open(\"r\") as fi:\n        while True:\n            start = chunk.find(row_start, start)  # row tag start\n            end = chunk.find(row_end, end)  # row tag end\n            if start == -1 or end == -1:\n                new = fi.read(100_000)\n                pbar.update(len(new))\n                if new == \"\":\n                    break\n                chunk += new\n                continue\n            # get indices from chunk\n            row = chunk[start + len(row_start) : end]\n            fields = [v.rstrip(value_end) for v in row.split(value_start)]\n            if not data:\n                headers = fields[:]\n                data = {f: [] for f in headers}\n                continue\n            else:\n                for field, header in zip(fields, headers):\n                    data[header].append(field)\n\n            chunk = chunk[end + len(row_end) :]\n\n            if len(data[headers[0]]) == Config.PAGE_SIZE:\n                if t is None:\n                    t = T(columns=data)\n                else:\n                    for k, v in data.items():\n                        t[k].extend(DataTypes.guess(v))\n                data = {f: [] for f in headers}\n\n    for k, v in data.items():\n        t[k].extend(DataTypes.guess(v))\n    return t\n</code></pre>"},{"location":"reference/import_utils/#tablite.import_utils.excel_reader","title":"<code>tablite.import_utils.excel_reader(T, path, first_row_has_headers=True, header_row_index=0, sheet=None, columns=None, skip_empty='NONE', start=0, limit=sys.maxsize, tqdm=_tqdm, **kwargs)</code>","text":"<p>returns Table from excel</p> <p>**kwargs are excess arguments that are ignored.</p> Source code in <code>tablite/import_utils.py</code> <pre><code>def excel_reader(T, path, first_row_has_headers=True, header_row_index=0, sheet=None, columns=None, skip_empty=\"NONE\", start=0, limit=sys.maxsize, tqdm=_tqdm, **kwargs):\n    \"\"\"\n    returns Table from excel\n\n    **kwargs are excess arguments that are ignored.\n    \"\"\"\n    if not issubclass(T, BaseTable):\n        raise TypeError(\"Expected subclass of Table\")\n\n    book = openpyxl.load_workbook(path, read_only=True, data_only=True)\n\n    if sheet is None:  # help the user.\n        \"\"\"\n            If no sheet specified, assume first sheet.\n\n            Reasoning:\n                Pandas ODS reader does that, so this preserves parity and it might be expected by users.\n                If we don't know the sheet name but only have single sheet,\n                    we would need to take extra steps to find out the name of the sheet.\n                We already make assumptions in case of column selection,\n                    when columns are None, we import all of them.\n        \"\"\"\n        sheet = book.sheetnames[0]\n    elif sheet not in book.sheetnames:\n        raise ValueError(f\"sheet not found: {sheet}\")\n\n    if not (isinstance(start, int) and start &gt;= 0):\n        raise ValueError(\"expected start as an integer &gt;=0\")\n    if not (isinstance(limit, int) and limit &gt; 0):\n        raise ValueError(\"expected limit as integer &gt; 0\")\n\n    worksheet = book[sheet]\n    fixup_worksheet(worksheet)\n\n    try:\n        it_header = worksheet.iter_rows(min_row=header_row_index + 1)\n        while True:\n            # get the first row to know our headers or the number of columns\n            row = [c.value for c in next(it_header)]\n            break\n        fields = [str(c) if c is not None else \"\" for c in row] # excel is offset by 1\n    except StopIteration:\n        # excel was empty, return empty table\n        return T()\n\n    if not first_row_has_headers:\n        # since the first row did not contain headers, we use the column count to populate header names\n        fields = [str(i) for i in range(len(fields))]\n\n    if columns is None:\n        # no columns were specified by user to import, that means we import all of the them\n        columns = []\n\n        for f in fields:\n            # fixup the duplicate column names\n            columns.append(unique_name(f, columns))\n\n        field_dict = {k: i for i, k in enumerate(columns)}\n    else:\n        field_dict = {}\n\n        for k, i in ((k, fields.index(k)) for k in columns):\n            # fixup the duplicate column names\n            field_dict[unique_name(k, field_dict.keys())] = i\n\n    # calculate our data rows iterator offset\n    it_offset = start + (1 if first_row_has_headers else 0) + header_row_index + 1\n\n    # attempt to fetch number of rows in the sheet\n    total_rows = worksheet.max_row\n    real_tqdm = True\n\n    if total_rows is None:\n        # i don't know what causes it but max_row can be None in some cases, so we don't know how large the dataset is\n        total_rows = it_offset + limit\n        real_tqdm = False\n\n    # create the actual data rows iterator\n    it_rows = worksheet.iter_rows(min_row=it_offset, max_row=min(it_offset+limit, total_rows))\n    it_used_indices = list(field_dict.values())\n\n    # filter columns that we're not going to use\n    it_rows_filtered = ([row[idx].value for idx in it_used_indices] for row in it_rows)\n\n    # create page directory\n    workdir = Path(Config.workdir) / Config.pid\n    pagesdir = workdir/\"pages\"\n    pagesdir.mkdir(exist_ok=True, parents=True)\n\n    field_names = list(field_dict.keys())\n    column_count = len(field_names)\n\n    page_fhs = None\n\n    # prepopulate the table with columns\n    table = T()\n    for name in field_names:\n        table[name] = Column(table.path)\n\n    pbar_fname = path.name\n    if len(pbar_fname) &gt; 20:\n        pbar_fname = pbar_fname[0:10] + \"...\" + pbar_fname[-7:]\n\n    if real_tqdm:\n        # we can create a true tqdm progress bar, make one\n        tqdm_iter = tqdm(it_rows_filtered, total=total_rows, desc=f\"importing excel: {pbar_fname}\")\n    else:\n        \"\"\"\n            openpyxls was unable to precalculate the size of the excel for whatever reason\n            forcing recalc would require parsing entire file\n            drop the progress bar in that case, just show iterations\n\n            as an alternative we can use \u03a3=1/x but it just doesn't look good, show iterations per second instead\n        \"\"\"\n        tqdm_iter = tqdm(it_rows_filtered, desc=f\"importing excel: {pbar_fname}\")\n\n    tqdm_iter = iter(tqdm_iter)\n\n    idx = 0\n\n    while True:\n        try:\n            row = next(tqdm_iter)\n        except StopIteration:\n            break # because in some cases we can't know the size of excel to set the upper iterator limit we loop until stop iteration is encountered\n\n        if skip_empty == \"ALL\" and all(v is None for v in row):\n            continue\n        elif skip_empty == \"ANY\" and any(v is None for v in row):\n            continue\n\n        if idx % Config.PAGE_SIZE == 0:\n            if page_fhs is not None:\n                # we reached the max page file size, fix the pages\n                [_fix_xls_page(table, c, fh) for c, fh in zip(field_names, page_fhs)]\n\n            page_fhs = [None] * column_count\n\n            for cidx in range(column_count):\n                # allocate new pages\n                pg_path = pagesdir / f\"{next(Page.ids)}.npy\"\n                page_fhs[cidx] = open(pg_path, \"wb\")\n\n        for fh, value in zip(page_fhs, row):\n            \"\"\"\n                since excel types are already cast into appropriate type we're going to do two passes per page\n\n                we create our temporary custom format:\n                packed type|packed byte count|packed bytes|...\n\n                available types:\n                    * q - int64\n                    * d - float64\n                    * s - string\n                    * b - boolean\n                    * n - none\n                    * p - pickled (date, time, datetime)\n            \"\"\"\n            dtype = type(value)\n\n            if dtype == int:\n                ptype, bytes_ = b'q', struct.pack('q', value) # pack int as int64\n            elif dtype == float:\n                ptype, bytes_ = b'd', struct.pack('d', value) # pack float as float64\n            elif dtype == str:\n                ptype, bytes_ = b's', value.encode(\"utf-8\")   # pack string\n            elif dtype == bool:\n                ptype, bytes_ = b'b', b'1' if value else b'0' # pack boolean\n            elif value is None:\n                ptype, bytes_ = b'n', b''                     # pack none\n            elif dtype in [date, time, datetime]:\n                ptype, bytes_ = b'p', pkl.dumps(value)        # pack object types via pickle\n            else:\n                raise NotImplementedError()\n\n            byte_count = struct.pack('I', len(bytes_))        # pack our payload size, i doubt payload size can be over uint32\n\n            # dump object to file\n            fh.write(ptype)\n            fh.write(byte_count)\n            fh.write(bytes_)\n\n        idx = idx + 1\n\n    if page_fhs is not None:\n        # we reached end of the loop, fix the pages\n        [_fix_xls_page(table, c, fh) for c, fh in zip(field_names, page_fhs)]\n\n    return table\n</code></pre>"},{"location":"reference/import_utils/#tablite.import_utils.ods_reader","title":"<code>tablite.import_utils.ods_reader(T, path, first_row_has_headers=True, header_row_index=0, sheet=None, columns=None, skip_empty='NONE', start=0, limit=sys.maxsize, **kwargs)</code>","text":"<p>returns Table from .ODS</p> Source code in <code>tablite/import_utils.py</code> <pre><code>def ods_reader(T, path, first_row_has_headers=True, header_row_index=0, sheet=None, columns=None, skip_empty=\"NONE\", start=0, limit=sys.maxsize, **kwargs):\n    \"\"\"\n    returns Table from .ODS\n    \"\"\"\n    if not issubclass(T, BaseTable):\n        raise TypeError(\"Expected subclass of Table\")\n\n    if sheet is None:\n        data = read_excel(str(path), header=None) # selects first sheet\n    else:\n        data = read_excel(str(path), sheet_name=sheet, header=None)\n\n    data[isna(data)] = None  # convert any empty cells to None\n    data = data.to_numpy().tolist() # convert pandas to list\n\n    if skip_empty == \"ALL\" or skip_empty == \"ANY\":\n        \"\"\" filter out all rows based on predicate that come after header row \"\"\"\n        fn_filter = any if skip_empty == \"ALL\" else all # this is intentional\n        data = [\n            row\n            for ridx, row in enumerate(data)\n            if ridx &lt; header_row_index + (1 if first_row_has_headers else 0) or fn_filter(not (v is None or isinstance(v, str) and len(v) == 0) for v in row)\n        ]\n\n    data = np.array(data, dtype=np.object_) # cast back to numpy array for slicing but don't try to convert datatypes\n\n    if not (isinstance(start, int) and start &gt;= 0):\n        raise ValueError(\"expected start as an integer &gt;=0\")\n    if not (isinstance(limit, int) and limit &gt; 0):\n        raise ValueError(\"expected limit as integer &gt; 0\")\n\n    t = T()\n\n    used_columns_names = set()\n    for ix, value in enumerate(data[header_row_index]):\n        if first_row_has_headers:\n            header, start_row_pos = \"\" if value is None else str(value), (1 + header_row_index)\n        else:\n            header, start_row_pos = f\"_{ix + 1}\", (0 + header_row_index)\n\n        if columns is not None:\n            if header not in columns:\n                continue\n\n        unique_column_name = unique_name(str(header), used_columns_names)\n        used_columns_names.add(unique_column_name)\n\n        column_values = data[start_row_pos : start_row_pos + limit, ix]\n\n        t[unique_column_name] = column_values\n    return t\n</code></pre>"},{"location":"reference/import_utils/#tablite.import_utils.text_reader_task","title":"<code>tablite.import_utils.text_reader_task(source, destination, start, end, guess_datatypes, delimiter, text_qualifier, text_escape_openings, text_escape_closures, strip_leading_and_tailing_whitespace, encoding, newline_offsets, fields)</code>","text":"<p>PARALLEL TASK FUNCTION reads columnsname + path[start:limit] into hdf5.</p> <p>source: csv or txt file destination: filename for page. start: int: start of page. end: int: end of page. guess_datatypes: bool: if True datatypes will be inferred by datatypes.Datatypes.guess delimiter: ',' ';' or '|' text_qualifier: str: commonly \" text_escape_openings: str: default: \"({[ text_escape_closures: str: default: ]})\" strip_leading_and_tailing_whitespace: bool encoding: chardet encoding ('utf-8, 'ascii', ..., 'ISO-22022-CN')</p> Source code in <code>tablite/import_utils.py</code> <pre><code>def text_reader_task(\n    source,\n    destination,\n    start,\n    end,\n    guess_datatypes,\n    delimiter,\n    text_qualifier,\n    text_escape_openings,\n    text_escape_closures,\n    strip_leading_and_tailing_whitespace,\n    encoding,\n    newline_offsets,\n    fields\n):\n    \"\"\"PARALLEL TASK FUNCTION\n    reads columnsname + path[start:limit] into hdf5.\n\n    source: csv or txt file\n    destination: filename for page.\n    start: int: start of page.\n    end: int: end of page.\n    guess_datatypes: bool: if True datatypes will be inferred by datatypes.Datatypes.guess\n    delimiter: ',' ';' or '|'\n    text_qualifier: str: commonly \\\"\n    text_escape_openings: str: default: \"({[\n    text_escape_closures: str: default: ]})\"\n    strip_leading_and_tailing_whitespace: bool\n    encoding: chardet encoding ('utf-8, 'ascii', ..., 'ISO-22022-CN')\n    \"\"\"\n    if isinstance(source, str):\n        source = Path(source)\n    type_check(source, Path)\n    if not source.exists():\n        raise FileNotFoundError(f\"File not found: {source}\")\n    type_check(destination, list)\n\n    # declare CSV dialect.\n    delim = delimiter\n\n    class Dialect(csv.Dialect):\n        delimiter = delim\n        quotechar = '\"' if text_qualifier is None else text_qualifier\n        escapechar = '\\\\'\n        doublequote = True\n        quoting = csv.QUOTE_MINIMAL\n        skipinitialspace = False if strip_leading_and_tailing_whitespace is None else strip_leading_and_tailing_whitespace\n        lineterminator = \"\\n\"\n\n    with source.open(\"r\", encoding=encoding, errors=\"ignore\") as fi:  # --READ\n        fi.seek(newline_offsets[start])\n        reader = csv.reader(fi, dialect=Dialect)\n\n        # if there's an issue with file handlers on windows, we can make a special case for windows where the file is opened on demand and appended instead of opening all handlers at once\n        page_file_handlers = [open(f, mode=\"wb\") for f in destination]\n\n        # identify longest str\n        longest_str = [1 for _ in range(len(destination))]\n        for row in (next(reader) for _ in range(end - start)):\n            for idx, c in ((fields[idx], c) for idx, c in filter(lambda t: t[0] in fields, enumerate(row))):\n                longest_str[idx] = max(longest_str[idx], len(c))\n\n        column_formats = [f\"&lt;U{i}\" for i in longest_str]\n        for idx, cf in enumerate(column_formats):\n            _create_numpy_header(cf, (end - start, ), page_file_handlers[idx])\n\n        # write page arrays to files\n        fi.seek(newline_offsets[start])\n        for row in (next(reader) for _ in range(end - start)):\n            for idx, c in ((fields[idx], c) for idx, c in filter(lambda t: t[0] in fields, enumerate(row))):\n                cbytes = np.asarray(c, dtype=column_formats[idx]).tobytes()\n                page_file_handlers[idx].write(cbytes)\n\n        [phf.close() for phf in page_file_handlers]\n</code></pre>"},{"location":"reference/import_utils/#tablite.import_utils.text_reader","title":"<code>tablite.import_utils.text_reader(T, path, columns, first_row_has_headers, header_row_index, encoding, start, limit, newline, guess_datatypes, text_qualifier, strip_leading_and_tailing_whitespace, skip_empty, delimiter, text_escape_openings, text_escape_closures, tqdm=_tqdm, **kwargs)</code>","text":"Source code in <code>tablite/import_utils.py</code> <pre><code>def text_reader(\n    T,\n    path,\n    columns,\n    first_row_has_headers,\n    header_row_index,\n    encoding,\n    start,\n    limit,\n    newline,\n    guess_datatypes,\n    text_qualifier,\n    strip_leading_and_tailing_whitespace,\n    skip_empty,\n    delimiter,\n    text_escape_openings,\n    text_escape_closures,\n    tqdm=_tqdm,\n    **kwargs,\n):\n    if encoding is None:\n        encoding = get_encoding(path, nbytes=ENCODING_GUESS_BYTES)\n\n    enc = py_to_nim_encoding(encoding)\n    pid = Config.workdir / Config.pid\n    kwargs = {}\n\n    if first_row_has_headers is not None:\n        kwargs[\"first_row_has_headers\"] = first_row_has_headers\n    if header_row_index is not None:\n        kwargs[\"header_row_index\"] = header_row_index\n    if columns is not None:\n        kwargs[\"columns\"] = columns\n    if start is not None:\n        kwargs[\"start\"] = start\n    if limit is not None and limit != sys.maxsize:\n        kwargs[\"limit\"] = limit\n    if guess_datatypes is not None:\n        kwargs[\"guess_datatypes\"] = guess_datatypes\n    if newline is not None:\n        kwargs[\"newline\"] = newline\n    if delimiter is not None:\n        kwargs[\"delimiter\"] = delimiter\n    if text_qualifier is not None:\n        kwargs[\"text_qualifier\"] = text_qualifier\n        kwargs[\"quoting\"] = \"QUOTE_MINIMAL\"\n    else:\n        kwargs[\"quoting\"] = \"QUOTE_NONE\"\n    if strip_leading_and_tailing_whitespace is not None:\n        kwargs[\"strip_leading_and_tailing_whitespace\"] = strip_leading_and_tailing_whitespace\n\n    if skip_empty is None:\n        kwargs[\"skip_empty\"] = \"NONE\"\n    else:\n        kwargs[\"skip_empty\"] = skip_empty\n\n    return nimlite.text_reader(\n        T, pid, path, enc,\n        **kwargs,\n        tqdm=tqdm\n    )\n</code></pre>"},{"location":"reference/import_utils/#tablite.import_utils-modules","title":"Modules","text":""},{"location":"reference/imputation/","title":"Imputation","text":""},{"location":"reference/imputation/#tablite.imputation","title":"<code>tablite.imputation</code>","text":""},{"location":"reference/imputation/#tablite.imputation-classes","title":"Classes","text":""},{"location":"reference/imputation/#tablite.imputation-functions","title":"Functions","text":""},{"location":"reference/imputation/#tablite.imputation.imputation","title":"<code>tablite.imputation.imputation(T, targets, missing=None, method='carry forward', sources=None, tqdm=_tqdm, pbar=None)</code>","text":"<p>In statistics, imputation is the process of replacing missing data with substituted values.</p> <p>See more: https://en.wikipedia.org/wiki/Imputation_(statistics)</p> PARAMETER  DESCRIPTION <code>table</code> <p>source table.</p> <p> TYPE: <code>Table</code> </p> <code>targets</code> <p>column names to find and replace missing values</p> <p> TYPE: <code>str or list of strings</code> </p> <code>missing</code> <p>values to be replaced.</p> <p> TYPE: <code>None or iterable</code> DEFAULT: <code>None</code> </p> <code>method</code> <p>method to be used for replacement. Options:</p> <p>'carry forward':     takes the previous value, and carries forward into fields     where values are missing.     +: quick. Realistic on time series.     -: Can produce strange outliers.</p> <p>'mean':     calculates the column mean (exclude <code>missing</code>) and copies     the mean in as replacement.     +: quick     -: doesn't work on text. Causes data set to drift towards the mean.</p> <p>'mode':     calculates the column mode (exclude <code>missing</code>) and copies     the mean in as replacement.     +: quick     -: most frequent value becomes over-represented in the sample</p> <p>'nearest neighbour':     calculates normalised distance between items in source columns     selects nearest neighbour and copies value as replacement.     +: works for any datatype.     -: computationally intensive (e.g. slow)</p> <p> TYPE: <code>str</code> DEFAULT: <code>'carry forward'</code> </p> <code>sources</code> <p>NEAREST NEIGHBOUR ONLY column names to be used during imputation. if None or empty, all columns will be used.</p> <p> TYPE: <code>list of strings</code> DEFAULT: <code>None</code> </p> RETURNS DESCRIPTION <code>table</code> <p>table with replaced values.</p> Source code in <code>tablite/imputation.py</code> <pre><code>def imputation(T, targets, missing=None, method=\"carry forward\", sources=None, tqdm=_tqdm, pbar=None):\n    \"\"\"\n    In statistics, imputation is the process of replacing missing data with substituted values.\n\n    See more: https://en.wikipedia.org/wiki/Imputation_(statistics)\n\n    Args:\n        table (Table): source table.\n\n        targets (str or list of strings): column names to find and\n            replace missing values\n\n        missing (None or iterable): values to be replaced.\n\n        method (str): method to be used for replacement. Options:\n\n            'carry forward':\n                takes the previous value, and carries forward into fields\n                where values are missing.\n                +: quick. Realistic on time series.\n                -: Can produce strange outliers.\n\n            'mean':\n                calculates the column mean (exclude `missing`) and copies\n                the mean in as replacement.\n                +: quick\n                -: doesn't work on text. Causes data set to drift towards the mean.\n\n            'mode':\n                calculates the column mode (exclude `missing`) and copies\n                the mean in as replacement.\n                +: quick\n                -: most frequent value becomes over-represented in the sample\n\n            'nearest neighbour':\n                calculates normalised distance between items in source columns\n                selects nearest neighbour and copies value as replacement.\n                +: works for any datatype.\n                -: computationally intensive (e.g. slow)\n\n        sources (list of strings): NEAREST NEIGHBOUR ONLY\n            column names to be used during imputation.\n            if None or empty, all columns will be used.\n\n    Returns:\n        table: table with replaced values.\n    \"\"\"\n    sub_cls_check(T, BaseTable)\n\n    if isinstance(targets, str) and targets not in T.columns:\n        targets = [targets]\n    if isinstance(targets, list):\n        for name in targets:\n            if not isinstance(name, str):\n                raise TypeError(f\"expected str, not {type(name)}\")\n            if name not in T.columns:\n                raise ValueError(f\"target item {name} not a column name in T.columns:\\n{T.columns}\")\n    else:\n        raise TypeError(\"Expected source as list of column names\")\n\n    if missing is None:\n        missing = {None}\n    else:\n        missing = set(missing)\n\n    if method == \"nearest neighbour\":\n        if sources in (None, []):\n            sources = list(T.columns)\n        if isinstance(sources, str):\n            sources = [sources]\n        if isinstance(sources, list):\n            for name in sources:\n                if not isinstance(name, str):\n                    raise TypeError(f\"expected str, not {type(name)}\")\n                if name not in T.columns:\n                    raise ValueError(f\"source item {name} not a column name in T.columns:\\n{T.columns}\")\n        else:\n            raise TypeError(\"Expected source as list of column names\")\n\n    methods = [\"nearest neighbour\", \"mean\", \"mode\", \"carry forward\"]\n\n    if method == \"carry forward\":\n        return carry_forward(T, targets, missing, tqdm=tqdm, pbar=pbar)\n    elif method in {\"mean\", \"mode\"}:\n        return stats_method(T, targets, missing, method, tqdm=tqdm, pbar=pbar)\n    elif method == \"nearest neighbour\":\n        return nearest_neighbour(T, sources, missing, targets, tqdm=tqdm)\n    else:\n        raise ValueError(f\"method {method} not recognised amonst known methods: {list(methods)})\")\n</code></pre>"},{"location":"reference/imputation/#tablite.imputation.carry_forward","title":"<code>tablite.imputation.carry_forward(T, targets, missing, tqdm=_tqdm, pbar=None)</code>","text":"Source code in <code>tablite/imputation.py</code> <pre><code>def carry_forward(T, targets, missing, tqdm=_tqdm, pbar=None):\n    assert isinstance(missing, set)\n\n    if pbar is None:\n        total = len(targets) * len(T)\n        pbar = tqdm(total=total, desc=\"imputation.carry_forward\", disable=Config.TQDM_DISABLE)\n\n    new = T.copy()\n    for name in T.columns:\n        if name in targets:\n            data = T[name][:]  # create copy\n            last_value = None\n            for ix, v in enumerate(data):\n                if v in missing:  # perform replacement\n                    data[ix] = last_value\n                else:  # keep last value.\n                    last_value = v\n                pbar.update(1)\n            new[name] = data\n        else:\n            new[name] = T[name]\n\n    return new\n</code></pre>"},{"location":"reference/imputation/#tablite.imputation.stats_method","title":"<code>tablite.imputation.stats_method(T, targets, missing, method, tqdm=_tqdm, pbar=None)</code>","text":"Source code in <code>tablite/imputation.py</code> <pre><code>def stats_method(T, targets, missing, method, tqdm=_tqdm, pbar=None):\n    assert isinstance(missing, set)\n\n    if pbar is None:\n        total = len(targets)\n        pbar = tqdm(total=total, desc=f\"imputation.{method}\", disable=Config.TQDM_DISABLE)\n\n    new = T.copy()\n    for name in T.columns:\n        if name in targets:\n            col = T.columns[name]\n            assert isinstance(col, Column)\n\n            hist_values, hist_counts = col.histogram()\n\n            for m in missing:\n                try:\n                    idx = hist_values.index(m)\n                    hist_counts[idx] = 0\n                except ValueError:\n                    pass\n\n            stats = summary_statistics(hist_values, hist_counts)\n\n            new_value = stats[method]\n            col.replace(mapping={m: new_value for m in missing})\n            new[name] = col\n            pbar.update(1)\n        else:\n            new[name] = T[name]  # no entropy, keep as is.\n\n    return new\n</code></pre>"},{"location":"reference/imputation/#tablite.imputation-modules","title":"Modules","text":""},{"location":"reference/joins/","title":"Joins","text":""},{"location":"reference/joins/#tablite.joins","title":"<code>tablite.joins</code>","text":""},{"location":"reference/joins/#tablite.joins-classes","title":"Classes","text":""},{"location":"reference/joins/#tablite.joins-functions","title":"Functions","text":""},{"location":"reference/joins/#tablite.joins.join","title":"<code>tablite.joins.join(T: BaseTable, other: BaseTable, left_keys: List[str], right_keys: List[str], left_columns: Union[List[str], None], right_columns: Union[List[str], None], kind: str = 'inner', merge_keys: bool = False, tqdm=_tqdm, pbar=None)</code>","text":"<p>short-cut for all join functions.</p> PARAMETER  DESCRIPTION <code>T</code> <p>left table</p> <p> TYPE: <code>Table</code> </p> <code>other</code> <p>right table</p> <p> TYPE: <code>Table</code> </p> <code>left_keys</code> <p>list of keys for the join from left table.</p> <p> TYPE: <code>list</code> </p> <code>right_keys</code> <p>list of keys for the join from right table.</p> <p> TYPE: <code>list</code> </p> <code>left_columns</code> <p>list of columns names to retain from left table. If None, all are retained.</p> <p> TYPE: <code>list</code> </p> <code>right_columns</code> <p>list of columns names to retain from right table. If None, all are retained.</p> <p> TYPE: <code>list</code> </p> <code>kind</code> <p>'inner', 'left', 'outer', 'cross'. Defaults to \"inner\".</p> <p> TYPE: <code>str</code> DEFAULT: <code>'inner'</code> </p> <code>tqdm</code> <p>tqdm progress counter. Defaults to _tqdm.</p> <p> TYPE: <code>tqdm</code> DEFAULT: <code>tqdm</code> </p> <code>pbar</code> <p>tqdm.progressbar. Defaults to None.</p> <p> TYPE: <code>pbar</code> DEFAULT: <code>None</code> </p> RAISES DESCRIPTION <code>ValueError</code> <p>if join type is unknown.</p> RETURNS DESCRIPTION <code>Table</code> <p>joined table.</p> <p>Example: \"inner\"</p> <pre><code>SQL:   SELECT number, letter FROM numbers JOIN letters ON numbers.colour == letters.color\n</code></pre> <p>Tablite: </p> <pre><code>&gt;&gt;&gt; inner_join = numbers.inner_join(\n    letters, \n    left_keys=['colour'], \n    right_keys=['color'], \n    left_columns=['number'], \n    right_columns=['letter']\n)\n</code></pre> <p>Example: \"left\" </p> <pre><code>SQL:   SELECT number, letter FROM numbers LEFT JOIN letters ON numbers.colour == letters.color\n</code></pre> <p>Tablite: </p> <pre><code>&gt;&gt;&gt; left_join = numbers.left_join(\n    letters, \n    left_keys=['colour'], \n    right_keys=['color'], \n    left_columns=['number'], \n    right_columns=['letter']\n)\n</code></pre> <p>Example: \"outer\"</p> <pre><code>SQL:   SELECT number, letter FROM numbers OUTER JOIN letters ON numbers.colour == letters.color\n</code></pre> <p>Tablite: </p> <pre><code>&gt;&gt;&gt; outer_join = numbers.outer_join(\n    letters, \n    left_keys=['colour'], \n    right_keys=['color'], \n    left_columns=['number'], \n    right_columns=['letter']\n    )\n</code></pre> <p>Example: \"cross\"</p> <p>CROSS JOIN returns the Cartesian product of rows from tables in the join. In other words, it will produce rows which combine each row from the first table with each row from the second table</p> Source code in <code>tablite/joins.py</code> <pre><code>def join(\n    T: BaseTable,\n    other: BaseTable,\n    left_keys: List[str],\n    right_keys: List[str],\n    left_columns: Union[List[str], None],\n    right_columns: Union[List[str], None],\n    kind: str = \"inner\",\n    merge_keys: bool = False,\n    tqdm=_tqdm,\n    pbar=None,\n):\n    \"\"\"short-cut for all join functions.\n\n    Args:\n        T (Table): left table\n        other (Table): right table\n        left_keys (list): list of keys for the join from left table.\n        right_keys (list): list of keys for the join from right table.\n        left_columns (list): list of columns names to retain from left table.\n            If None, all are retained.\n        right_columns (list): list of columns names to retain from right table.\n            If None, all are retained.\n        kind (str, optional): 'inner', 'left', 'outer', 'cross'. Defaults to \"inner\".\n        tqdm (tqdm, optional): tqdm progress counter. Defaults to _tqdm.\n        pbar (tqdm.pbar, optional): tqdm.progressbar. Defaults to None.\n\n    Raises:\n        ValueError: if join type is unknown.\n\n    Returns:\n        Table: joined table.\n\n    Example: \"inner\"\n    ```\n    SQL:   SELECT number, letter FROM numbers JOIN letters ON numbers.colour == letters.color\n    ```\n    Tablite: \n    ```\n    &gt;&gt;&gt; inner_join = numbers.inner_join(\n        letters, \n        left_keys=['colour'], \n        right_keys=['color'], \n        left_columns=['number'], \n        right_columns=['letter']\n    )\n    ```\n\n    Example: \"left\" \n    ```\n    SQL:   SELECT number, letter FROM numbers LEFT JOIN letters ON numbers.colour == letters.color\n    ```\n    Tablite: \n    ```\n    &gt;&gt;&gt; left_join = numbers.left_join(\n        letters, \n        left_keys=['colour'], \n        right_keys=['color'], \n        left_columns=['number'], \n        right_columns=['letter']\n    )\n    ```\n\n    Example: \"outer\"\n    ```\n    SQL:   SELECT number, letter FROM numbers OUTER JOIN letters ON numbers.colour == letters.color\n    ```\n\n    Tablite: \n    ```\n    &gt;&gt;&gt; outer_join = numbers.outer_join(\n        letters, \n        left_keys=['colour'], \n        right_keys=['color'], \n        left_columns=['number'], \n        right_columns=['letter']\n        )\n    ```\n\n    Example: \"cross\"\n\n    CROSS JOIN returns the Cartesian product of rows from tables in the join.\n    In other words, it will produce rows which combine each row from the first table\n    with each row from the second table\n    \"\"\"\n    if left_columns is None:\n        left_columns = list(T.columns)\n    if right_columns is None:\n        right_columns = list(other.columns)\n    assert merge_keys in {True,False}\n\n    _jointype_check(T, other, left_keys, right_keys, left_columns, right_columns)\n\n    return _join(kind, T,other,left_keys, right_keys, left_columns, right_columns, merge_keys=merge_keys,\n             tqdm=tqdm, pbar=pbar)\n</code></pre>"},{"location":"reference/joins/#tablite.joins.inner_join","title":"<code>tablite.joins.inner_join(T: BaseTable, other: BaseTable, left_keys: List[str], right_keys: List[str], left_columns: Union[List[str], None], right_columns: Union[List[str], None], merge_keys: bool = False, tqdm=_tqdm, pbar=None)</code>","text":"Source code in <code>tablite/joins.py</code> <pre><code>def inner_join(T: BaseTable, other: BaseTable, left_keys: List[str], right_keys: List[str], \n              left_columns: Union[List[str], None], right_columns: Union[List[str], None],\n              merge_keys: bool = False, tqdm=_tqdm, pbar=None):\n    return join(T, other, left_keys, right_keys, left_columns, right_columns, kind=\"inner\", merge_keys=merge_keys, tqdm=tqdm,pbar=pbar)\n</code></pre>"},{"location":"reference/joins/#tablite.joins.left_join","title":"<code>tablite.joins.left_join(T: BaseTable, other: BaseTable, left_keys: List[str], right_keys: List[str], left_columns: Union[List[str], None], right_columns: Union[List[str], None], merge_keys: bool = False, tqdm=_tqdm, pbar=None)</code>","text":"Source code in <code>tablite/joins.py</code> <pre><code>def left_join(T: BaseTable, other: BaseTable, left_keys: List[str], right_keys: List[str], \n              left_columns: Union[List[str], None], right_columns: Union[List[str], None],\n              merge_keys: bool = False, tqdm=_tqdm, pbar=None):\n    return join(T, other, left_keys, right_keys, left_columns, right_columns, kind=\"left\", merge_keys=merge_keys, tqdm=tqdm,pbar=pbar)\n</code></pre>"},{"location":"reference/joins/#tablite.joins.outer_join","title":"<code>tablite.joins.outer_join(T: BaseTable, other: BaseTable, left_keys: List[str], right_keys: List[str], left_columns: Union[List[str], None], right_columns: Union[List[str], None], merge_keys: bool = False, tqdm=_tqdm, pbar=None)</code>","text":"Source code in <code>tablite/joins.py</code> <pre><code>def outer_join(T: BaseTable, other: BaseTable, left_keys: List[str], right_keys: List[str], \n              left_columns: Union[List[str], None], right_columns: Union[List[str], None],\n              merge_keys: bool = False, tqdm=_tqdm, pbar=None):\n    return join(T, other, left_keys, right_keys, left_columns, right_columns, kind=\"outer\", merge_keys=merge_keys, tqdm=tqdm,pbar=pbar)\n</code></pre>"},{"location":"reference/joins/#tablite.joins.cross_join","title":"<code>tablite.joins.cross_join(T: BaseTable, other: BaseTable, left_keys: List[str], right_keys: List[str], left_columns: Union[List[str], None], right_columns: Union[List[str], None], merge_keys: bool = False, tqdm=_tqdm, pbar=None)</code>","text":"Source code in <code>tablite/joins.py</code> <pre><code>def cross_join(T: BaseTable, other: BaseTable, left_keys: List[str], right_keys: List[str], \n              left_columns: Union[List[str], None], right_columns: Union[List[str], None],\n              merge_keys: bool = False, tqdm=_tqdm, pbar=None):\n    return join(T, other, left_keys, right_keys, left_columns, right_columns, kind=\"cross\", merge_keys=merge_keys, tqdm=tqdm,pbar=pbar)\n</code></pre>"},{"location":"reference/lookup/","title":"Lookup","text":""},{"location":"reference/lookup/#tablite.lookup","title":"<code>tablite.lookup</code>","text":""},{"location":"reference/lookup/#tablite.lookup-attributes","title":"Attributes","text":""},{"location":"reference/lookup/#tablite.lookup-classes","title":"Classes","text":""},{"location":"reference/lookup/#tablite.lookup-functions","title":"Functions","text":""},{"location":"reference/lookup/#tablite.lookup.lookup","title":"<code>tablite.lookup.lookup(T, other, *criteria, all=True, tqdm=_tqdm)</code>","text":"<p>function for looking up values in <code>other</code> according to criteria in ascending order. :param: T: Table  :param: other: Table sorted in ascending search order. :param: criteria: Each criteria must be a tuple with value comparisons in the form:     (LEFT, OPERATOR, RIGHT) :param: all: boolean: True=ALL, False=ANY</p> <p>OPERATOR must be a callable that returns a boolean LEFT must be a value that the OPERATOR can compare. RIGHT must be a value that the OPERATOR can compare.</p> <p>Examples:</p> <p>comparison of two columns:</p> <pre><code>('column A', \"==\", 'column B')\n</code></pre> <p>compare value from column 'Date' with date 24/12.</p> <pre><code>('Date', \"&lt;\", DataTypes.date(24,12) )\n</code></pre> <p>uses custom function to compare value from column 'text 1' with value from column 'text 2'</p> <pre><code>f = lambda L,R: all( ord(L) &lt; ord(R) )\n('text 1', f, 'text 2')\n</code></pre> Source code in <code>tablite/lookup.py</code> <pre><code>def lookup(T, other, *criteria, all=True, tqdm=_tqdm):\n    \"\"\"function for looking up values in `other` according to criteria in ascending order.\n    :param: T: Table \n    :param: other: Table sorted in ascending search order.\n    :param: criteria: Each criteria must be a tuple with value comparisons in the form:\n        (LEFT, OPERATOR, RIGHT)\n    :param: all: boolean: True=ALL, False=ANY\n\n    OPERATOR must be a callable that returns a boolean\n    LEFT must be a value that the OPERATOR can compare.\n    RIGHT must be a value that the OPERATOR can compare.\n\n    Examples:\n        comparison of two columns:\n\n            ('column A', \"==\", 'column B')\n\n        compare value from column 'Date' with date 24/12.\n\n            ('Date', \"&lt;\", DataTypes.date(24,12) )\n\n        uses custom function to compare value from column\n        'text 1' with value from column 'text 2'\n\n            f = lambda L,R: all( ord(L) &lt; ord(R) )\n            ('text 1', f, 'text 2')\n\n    \"\"\"\n    sub_cls_check(T, BaseTable)\n    sub_cls_check(other, BaseTable)\n\n    all = all\n    any = not all\n\n    ops = lookup_ops\n\n    functions, left_criteria, right_criteria = [], set(), set()\n\n    for left, op, right in criteria:\n        left_criteria.add(left)\n        right_criteria.add(right)\n        if callable(op):\n            pass  # it's a custom function.\n        else:\n            op = ops.get(op, None)\n            if not callable(op):\n                raise ValueError(f\"{op} not a recognised operator for comparison.\")\n\n        functions.append((op, left, right))\n    left_columns = [n for n in left_criteria if n in T.columns]\n    right_columns = [n for n in right_criteria if n in other.columns]\n\n    result_index = np.empty(shape=(len(T)), dtype=np.int64)\n    cache = {}\n    left = T[left_columns]\n    Constr = type(T)\n    if isinstance(left, Column):\n        tmp, left = left, Constr()\n        left[left_columns[0]] = tmp\n    right = other[right_columns]\n    if isinstance(right, Column):\n        tmp, right = right, Constr()\n        right[right_columns[0]] = tmp\n    assert isinstance(left, BaseTable)\n    assert isinstance(right, BaseTable)\n\n    for ix, row1 in tqdm(enumerate(left.rows), total=len(T), disable=Config.TQDM_DISABLE):\n        row1_tup = tuple(row1)\n        row1d = {name: value for name, value in zip(left_columns, row1)}\n        row1_hash = hash(row1_tup)\n\n        match_found = True if row1_hash in cache else False\n\n        if not match_found:  # search.\n            for row2ix, row2 in enumerate(right.rows):\n                row2d = {name: value for name, value in zip(right_columns, row2)}\n\n                evaluations = {op(row1d.get(left, left), row2d.get(right, right)) for op, left, right in functions}\n                # The evaluations above does a neat trick:\n                # as L is a dict, L.get(left, L) will return a value\n                # from the columns IF left is a column name. If it isn't\n                # the function will treat left as a value.\n                # The same applies to right.\n                all_ = all and (False not in evaluations)\n                any_ = any and True in evaluations\n                if all_ or any_:\n                    match_found = True\n                    cache[row1_hash] = row2ix\n                    break\n\n        if not match_found:  # no match found.\n            cache[row1_hash] = -1  # -1 is replacement for None in the index as numpy can't handle Nones.\n\n        result_index[ix] = cache[row1_hash]\n\n    f = select_processing_method(2 * max(len(T), len(other)), _sp_lookup, _mp_lookup)\n    return f(T, other, result_index)\n</code></pre>"},{"location":"reference/match/","title":"Match","text":""},{"location":"reference/match/#tablite.match","title":"<code>tablite.match</code>","text":""},{"location":"reference/match/#tablite.match-classes","title":"Classes","text":""},{"location":"reference/match/#tablite.match-functions","title":"Functions","text":""},{"location":"reference/match/#tablite.match.match","title":"<code>tablite.match.match(T, other, *criteria, keep_left=None, keep_right=None)</code>","text":"<p>performs inner join where <code>T</code> matches <code>other</code> and removes rows that do not match.</p> <p>:param: T: Table :param: other: Table :param: criteria: Each criteria must be a tuple with value comparisons in the form:</p> <pre><code>(LEFT, OPERATOR, RIGHT), where operator must be \"==\"\n\nExample:\n    ('column A', \"==\", 'column B')\n\nThis syntax follows the lookup syntax. See Lookup for details.\n</code></pre> <p>:param: keep_left: list of columns to keep. :param: keep_right: list of right columns to keep.</p> Source code in <code>tablite/match.py</code> <pre><code>def match(T, other, *criteria, keep_left=None, keep_right=None):  # lookup and filter combined - drops unmatched rows.\n    \"\"\"\n    performs inner join where `T` matches `other` and removes rows that do not match.\n\n    :param: T: Table\n    :param: other: Table\n    :param: criteria: Each criteria must be a tuple with value comparisons in the form:\n\n        (LEFT, OPERATOR, RIGHT), where operator must be \"==\"\n\n        Example:\n            ('column A', \"==\", 'column B')\n\n        This syntax follows the lookup syntax. See Lookup for details.\n\n    :param: keep_left: list of columns to keep.\n    :param: keep_right: list of right columns to keep.\n    \"\"\"\n    assert isinstance(T, BaseTable)\n    assert isinstance(other, BaseTable)\n    if keep_left is None:\n        keep_left = [n for n in T.columns]\n    else:\n        type_check(keep_left, list)\n        name_check(T.columns, *keep_left)\n\n    if keep_right is None:\n        keep_right = [n for n in other.columns]\n    else:\n        type_check(keep_right, list)\n        name_check(other.columns, *keep_right)\n\n    indices = np.full(shape=(len(T),), fill_value=-1, dtype=np.int64)\n    for arg in criteria:\n        b,_,a = arg\n        if _ != \"==\":\n            raise ValueError(\"match requires A == B. For other logic visit `lookup`\")\n        if b not in T.columns:\n            raise ValueError(f\"Column {b} not found in T for criteria: {arg}\")\n        if a not in other.columns:\n            raise ValueError(f\"Column {a} not found in T for criteria: {arg}\")\n\n        index_update = find_indices(other[a][:], T[b][:], fill_value=-1)\n        indices = merge_indices(indices, index_update)\n\n    cls = type(T)\n    new = cls()\n    for name in T.columns:\n        if name in keep_left:\n            new[name] = np.compress(indices != -1, T[name][:])\n\n    for name in other.columns:\n        if name in keep_right:\n            new_name = unique_name(name, new.columns)\n            primary = np.compress(indices != -1, indices)\n            new[new_name] = np.take(other[name][:], primary)\n\n    return new\n</code></pre>"},{"location":"reference/match/#tablite.match.find_indices","title":"<code>tablite.match.find_indices(x, y, fill_value=-1)</code>","text":"<p>finds index of y in x</p> Source code in <code>tablite/match.py</code> <pre><code>def find_indices(x,y, fill_value=-1):  # fast.\n    \"\"\"\n    finds index of y in x\n    \"\"\"\n    # disassembly of numpy:\n    # import numpy as np\n    # x = np.array([3, 5, 7,  1,   9, 8, 6, 6])\n    # y = np.array([2, 1, 5, 10, 100, 6])\n    index = np.argsort(x)  # array([3, 0, 1, 6, 7, 2, 5, 4])\n    sorted_x = x[index]  # array([1, 3, 5, 6, 6, 7, 8, 9])\n    sorted_index = np.searchsorted(sorted_x, y)  # array([1, 0, 2, 8, 8, 3])\n    yindex = np.take(index, sorted_index, mode=\"clip\")  # array([0, 3, 1, 4, 4, 6])\n    mask = x[yindex] != y  # array([ True, False, False,  True,  True, False])\n    indices = np.ma.array(yindex, mask=mask, fill_value=fill_value)  \n    # masked_array(data=[--, 3, 1, --, --, 6], mask=[ True, False, False,  True,  True, False], fill_value=999999)\n    # --: y[0] not in x\n    # 3 : y[1] == x[3]\n    # 1 : y[2] == x[1]\n    # --: y[3] not in x\n    # --: y[4] not in x\n    # --: y[5] == x[6]\n    result = np.where(~indices.mask, indices.data, -1)  \n    return result  # array([-1,  3,  1, -1, -1,  6])\n</code></pre>"},{"location":"reference/match/#tablite.match.merge_indices","title":"<code>tablite.match.merge_indices(x1, *args, fill_value=-1)</code>","text":"<p>merges x1 and x2 where</p> Source code in <code>tablite/match.py</code> <pre><code>def merge_indices(x1, *args, fill_value=-1):\n    \"\"\"\n    merges x1 and x2 where \n    \"\"\"\n    # dis:\n    # &gt;&gt;&gt; AA = array([-1,  3, -1, 5])\n    # &gt;&gt;&gt; BB = array([-1, -1,  4, 5])\n    new = x1[:]  # = AA\n    for arg in args:\n        mask = (new == fill_value)  # array([True, False, True, False])\n        new = np.where(mask, arg, new)  # array([-1, 3, 4, 5])\n    return new   # array([-1, 3, 4, 5])\n</code></pre>"},{"location":"reference/merge/","title":"Merge","text":""},{"location":"reference/merge/#tablite.merge","title":"<code>tablite.merge</code>","text":""},{"location":"reference/merge/#tablite.merge-classes","title":"Classes","text":""},{"location":"reference/merge/#tablite.merge-functions","title":"Functions","text":""},{"location":"reference/merge/#tablite.merge.where","title":"<code>tablite.merge.where(T, criteria, left, right, new)</code>","text":"<p>takes from LEFT where criteria is True else RIGHT  and creates a single new column.</p> <p>:param: T: Table :param: criteria: np.array(bool):          if True take left column         else take right column :param left: (str) column name :param right: (str) column name :param new: (str) new name</p> <p>:returns: T</p> Source code in <code>tablite/merge.py</code> <pre><code>def where(T, criteria, left, right, new):\n    \"\"\" takes from LEFT where criteria is True else RIGHT \n    and creates a single new column.\n\n    :param: T: Table\n    :param: criteria: np.array(bool): \n            if True take left column\n            else take right column\n    :param left: (str) column name\n    :param right: (str) column name\n    :param new: (str) new name\n\n    :returns: T\n    \"\"\"\n    type_check(T, BaseTable)\n    if isinstance(criteria, np.ndarray):\n        if not criteria.dtype == \"bool\":\n            raise TypeError\n    else:\n        criteria = np.array(criteria, dtype='bool')\n\n    new_uq = unique_name(new, list(T.columns))\n    T.add_column(new_uq)\n    col = T[new_uq]\n\n    for start,end in Config.page_steps(len(criteria)):\n        left_values = T[left][start:end]\n        right_values = T[right][start:end]\n        new_values = np.where(criteria, left_values, right_values)\n        col.extend(new_values)\n\n    if new == right:\n        T[right] = T[new_uq]  # keep column order\n        del T[new_uq]\n        del T[left]\n    elif new == left:\n        T[left] = T[new_uq]  # keep column order\n        del T[new_uq]\n        del T[right]\n    else:\n        T[new] = T[new_uq]\n        del T[left]\n        del T[right]\n    return T\n</code></pre>"},{"location":"reference/mp_utils/","title":"Mp utils","text":""},{"location":"reference/mp_utils/#tablite.mp_utils","title":"<code>tablite.mp_utils</code>","text":""},{"location":"reference/mp_utils/#tablite.mp_utils-attributes","title":"Attributes","text":""},{"location":"reference/mp_utils/#tablite.mp_utils.lookup_ops","title":"<code>tablite.mp_utils.lookup_ops = {'in': _in, 'not in': not_in, '&lt;': operator.lt, '&lt;=': operator.le, '&gt;': operator.gt, '&gt;=': operator.ge, '!=': operator.ne, '==': operator.eq}</code>  <code>module-attribute</code>","text":""},{"location":"reference/mp_utils/#tablite.mp_utils.filter_ops","title":"<code>tablite.mp_utils.filter_ops = {'&gt;': operator.gt, '&gt;=': operator.ge, '==': operator.eq, '&lt;': operator.lt, '&lt;=': operator.le, '!=': operator.ne, 'in': _in}</code>  <code>module-attribute</code>","text":""},{"location":"reference/mp_utils/#tablite.mp_utils.filter_ops_from_text","title":"<code>tablite.mp_utils.filter_ops_from_text = {'gt': '&gt;', 'gteq': '&gt;=', 'eq': '==', 'lt': '&lt;', 'lteq': '&lt;=', 'neq': '!=', 'in': _in}</code>  <code>module-attribute</code>","text":""},{"location":"reference/mp_utils/#tablite.mp_utils-classes","title":"Classes","text":""},{"location":"reference/mp_utils/#tablite.mp_utils-functions","title":"Functions","text":""},{"location":"reference/mp_utils/#tablite.mp_utils.not_in","title":"<code>tablite.mp_utils.not_in(a, b)</code>","text":"Source code in <code>tablite/mp_utils.py</code> <pre><code>def not_in(a, b):\n    return not operator.contains(str(a), str(b))\n</code></pre>"},{"location":"reference/mp_utils/#tablite.mp_utils.is_mp","title":"<code>tablite.mp_utils.is_mp(fields: int) -&gt; bool</code>","text":"PARAMETER  DESCRIPTION <code>fields</code> <p>number of fields</p> <p> TYPE: <code>int</code> </p> RETURNS DESCRIPTION <code>bool</code> <p>bool</p> Source code in <code>tablite/mp_utils.py</code> <pre><code>def is_mp(fields: int) -&gt; bool:\n    \"\"\"\n\n    Args:\n        fields (int): number of fields\n\n    Returns:\n        bool\n    \"\"\"\n    if Config.MULTIPROCESSING_MODE == Config.FORCE:\n        return True\n\n    if Config.MULTIPROCESSING_MODE == Config.FALSE:\n        return False\n\n    if fields &lt; Config.SINGLE_PROCESSING_LIMIT:\n        return False\n\n    if max(psutil.cpu_count(logical=False), 1) &lt; 2:\n        return False\n\n    return True\n</code></pre>"},{"location":"reference/mp_utils/#tablite.mp_utils.select_processing_method","title":"<code>tablite.mp_utils.select_processing_method(fields, sp, mp)</code>","text":"PARAMETER  DESCRIPTION <code>fields</code> <p>number of fields</p> <p> TYPE: <code>int</code> </p> <code>sp</code> <p>method for single processing</p> <p> TYPE: <code>callable</code> </p> <code>mp</code> <p>method for multiprocessing</p> <p> TYPE: <code>callable</code> </p> RETURNS DESCRIPTION <code>_type_</code> <p>description</p> Source code in <code>tablite/mp_utils.py</code> <pre><code>def select_processing_method(fields, sp, mp):\n    \"\"\"\n\n    Args:\n        fields (int): number of fields\n        sp (callable): method for single processing\n        mp (callable): method for multiprocessing\n\n    Returns:\n        _type_: _description_\n    \"\"\"\n    return mp if is_mp(fields) else sp\n</code></pre>"},{"location":"reference/mp_utils/#tablite.mp_utils.maskify","title":"<code>tablite.mp_utils.maskify(arr)</code>","text":"Source code in <code>tablite/mp_utils.py</code> <pre><code>def maskify(arr):\n    none_mask = [False] * len(arr)  # Setting the default\n\n    for i in range(len(arr)):\n        if arr[i] is None:  # Check if our value is None\n            none_mask[i] = True\n            arr[i] = 0  # Remove None from the original array\n\n    return none_mask\n</code></pre>"},{"location":"reference/mp_utils/#tablite.mp_utils.share_mem","title":"<code>tablite.mp_utils.share_mem(inp_arr, dtype)</code>","text":"Source code in <code>tablite/mp_utils.py</code> <pre><code>def share_mem(inp_arr, dtype):\n    len_ = len(inp_arr)\n    size = np.dtype(dtype).itemsize * len_\n    shape = (len_,)\n\n    out_shm = shared_memory.SharedMemory(create=True, size=size)  # the co_processors will read this.\n    out_arr_index = np.ndarray(shape, dtype=dtype, buffer=out_shm.buf)\n    out_arr_index[:] = inp_arr\n\n    return out_arr_index, out_shm\n</code></pre>"},{"location":"reference/mp_utils/#tablite.mp_utils.map_task","title":"<code>tablite.mp_utils.map_task(data_shm_name, index_shm_name, destination_shm_name, shape, dtype, start, end)</code>","text":"Source code in <code>tablite/mp_utils.py</code> <pre><code>def map_task(data_shm_name, index_shm_name, destination_shm_name, shape, dtype, start, end):\n    # connect\n    shared_data = shared_memory.SharedMemory(name=data_shm_name)\n    data = np.ndarray(shape, dtype=dtype, buffer=shared_data.buf)\n\n    shared_index = shared_memory.SharedMemory(name=index_shm_name)\n    index = np.ndarray(shape, dtype=np.int64, buffer=shared_index.buf)\n\n    shared_target = shared_memory.SharedMemory(name=destination_shm_name)\n    target = np.ndarray(shape, dtype=dtype, buffer=shared_target.buf)\n    # work\n    target[start:end] = np.take(data[start:end], index[start:end])\n    # disconnect\n    shared_data.close()\n    shared_index.close()\n    shared_target.close()\n</code></pre>"},{"location":"reference/mp_utils/#tablite.mp_utils.reindex_task","title":"<code>tablite.mp_utils.reindex_task(src, dst, index_shm, shm_shape, start, end)</code>","text":"Source code in <code>tablite/mp_utils.py</code> <pre><code>def reindex_task(src, dst, index_shm, shm_shape, start, end):\n    # connect\n    existing_shm = shared_memory.SharedMemory(name=index_shm)\n    shared_index = np.ndarray(shm_shape, dtype=np.int64, buffer=existing_shm.buf)\n    # work\n    array = load_numpy(src)\n    new = np.take(array, shared_index[start:end])\n    np.save(dst, new, allow_pickle=True, fix_imports=False)\n    # disconnect\n    existing_shm.close()\n</code></pre>"},{"location":"reference/nimlite/","title":"Nimlite","text":""},{"location":"reference/nimlite/#tablite.nimlite","title":"<code>tablite.nimlite</code>","text":""},{"location":"reference/nimlite/#tablite.nimlite-attributes","title":"Attributes","text":""},{"location":"reference/nimlite/#tablite.nimlite.paths","title":"<code>tablite.nimlite.paths = sys.argv[:]</code>  <code>module-attribute</code>","text":""},{"location":"reference/nimlite/#tablite.nimlite.K","title":"<code>tablite.nimlite.K = TypeVar('K', bound=BaseTable)</code>  <code>module-attribute</code>","text":""},{"location":"reference/nimlite/#tablite.nimlite.ValidEncoders","title":"<code>tablite.nimlite.ValidEncoders = Literal['ENC_UTF8', 'ENC_UTF16', 'ENC_WIN1250']</code>  <code>module-attribute</code>","text":""},{"location":"reference/nimlite/#tablite.nimlite.ValidQuoting","title":"<code>tablite.nimlite.ValidQuoting = Literal['QUOTE_MINIMAL', 'QUOTE_ALL', 'QUOTE_NONNUMERIC', 'QUOTE_NONE', 'QUOTE_STRINGS', 'QUOTE_NOTNULL']</code>  <code>module-attribute</code>","text":""},{"location":"reference/nimlite/#tablite.nimlite.ValidSkipEmpty","title":"<code>tablite.nimlite.ValidSkipEmpty = Literal['NONE', 'ANY', 'ALL']</code>  <code>module-attribute</code>","text":""},{"location":"reference/nimlite/#tablite.nimlite.ColumnSelectorDict","title":"<code>tablite.nimlite.ColumnSelectorDict = TypedDict('ColumnSelectorDict', {'column': str, 'type': Literal['int', 'float', 'bool', 'str', 'date', 'time', 'datetime'], 'allow_empty': Union[bool, None], 'rename': Union[str, None]})</code>  <code>module-attribute</code>","text":""},{"location":"reference/nimlite/#tablite.nimlite.FilterCriteria","title":"<code>tablite.nimlite.FilterCriteria = Literal['&gt;', '&gt;=', '==', '&lt;', '&lt;=', '!=', 'in']</code>  <code>module-attribute</code>","text":""},{"location":"reference/nimlite/#tablite.nimlite.FilterType","title":"<code>tablite.nimlite.FilterType = Literal['all', 'any']</code>  <code>module-attribute</code>","text":""},{"location":"reference/nimlite/#tablite.nimlite.FilterDict","title":"<code>tablite.nimlite.FilterDict = TypedDict('FilterDict', {'column1': str, 'value1': Union[str, None], 'criteria': FilterCriteria, 'column2': str, 'value2': Union[str, None]})</code>  <code>module-attribute</code>","text":""},{"location":"reference/nimlite/#tablite.nimlite-classes","title":"Classes","text":""},{"location":"reference/nimlite/#tablite.nimlite-functions","title":"Functions","text":""},{"location":"reference/nimlite/#tablite.nimlite.get_headers","title":"<code>tablite.nimlite.get_headers(path: Union[str, Path], encoding: ValidEncoders = 'ENC_UTF8', *, header_row_index: int = 0, newline: str = '\\n', delimiter: str = ',', text_qualifier: str = '\"', quoting: ValidQuoting, strip_leading_and_tailing_whitespace: bool = True, linecount: int = 10) -&gt; list[list[str]]</code>","text":"Source code in <code>tablite/nimlite.py</code> <pre><code>def get_headers(\n    path: Union[str, Path],\n    encoding: ValidEncoders =\"ENC_UTF8\",\n    *,\n    header_row_index: int=0,\n    newline: str='\\n', delimiter: str=',', text_qualifier: str='\"',\n    quoting: ValidQuoting, strip_leading_and_tailing_whitespace: bool=True,\n    linecount: int = 10\n) -&gt; list[list[str]]:\n    return nl.get_headers(\n            path=str(path),\n            encoding=encoding,\n            newline=newline, delimiter=delimiter, text_qualifier=text_qualifier,\n            strip_leading_and_tailing_whitespace=strip_leading_and_tailing_whitespace,\n            header_row_index=header_row_index,\n            quoting=quoting,\n            linecount=linecount\n        )\n</code></pre>"},{"location":"reference/nimlite/#tablite.nimlite.text_reader","title":"<code>tablite.nimlite.text_reader(T: Type[K], pid: str, path: Union[str, Path], encoding: ValidEncoders = 'ENC_UTF8', *, first_row_has_headers: bool = True, header_row_index: int = 0, columns: List[Union[str, None]] = None, start: Union[str, None] = None, limit: Union[str, None] = None, guess_datatypes: bool = False, newline: str = '\\n', delimiter: str = ',', text_qualifier: str = '\"', quoting: ValidQuoting, strip_leading_and_tailing_whitespace: bool = True, skip_empty: ValidSkipEmpty = 'NONE', tqdm=_tqdm) -&gt; K</code>","text":"Source code in <code>tablite/nimlite.py</code> <pre><code>def text_reader(\n    T: Type[K],\n    pid: str, path: Union[str, Path],\n    encoding: ValidEncoders =\"ENC_UTF8\",\n    *,\n    first_row_has_headers: bool=True, header_row_index: int=0,\n    columns: List[Union[str, None]]=None,\n    start: Union[str, None] = None, limit: Union[str, None]=None,\n    guess_datatypes: bool =False,\n    newline: str='\\n', delimiter: str=',', text_qualifier: str='\"',\n    quoting: ValidQuoting, strip_leading_and_tailing_whitespace: bool=True, skip_empty: ValidSkipEmpty = \"NONE\",\n    tqdm=_tqdm\n) -&gt; K:\n    assert isinstance(path, Path)\n    assert isinstance(pid, Path)\n    with tqdm(total=10, desc=f\"importing file\") as pbar:\n        table = nl.text_reader(\n            pid=str(pid),\n            path=str(path),\n            encoding=encoding,\n            first_row_has_headers=first_row_has_headers, header_row_index=header_row_index,\n            columns=columns,\n            start=start, limit=limit,\n            guess_datatypes=guess_datatypes,\n            newline=newline, delimiter=delimiter, text_qualifier=text_qualifier,\n            quoting=quoting,\n            strip_leading_and_tailing_whitespace=strip_leading_and_tailing_whitespace,\n            skip_empty=skip_empty,\n            page_size=Config.PAGE_SIZE\n        )\n\n        pbar.update(1)\n\n        task_info = table[\"task\"]\n        task_columns = table[\"columns\"]\n\n        ti_tasks = task_info[\"tasks\"]\n        ti_import_field_names = task_info[\"import_field_names\"]\n\n        is_windows = platform.system() == \"Windows\"\n        use_logical = False if is_windows else True\n\n        cpus = max(psutil.cpu_count(logical=use_logical), 1)\n\n        pbar_step = 4 / max(len(ti_tasks), 1)\n\n        class WrapUpdate:\n            def update(self, n):\n                pbar.update(n * pbar_step)\n\n        wrapped_pbar = WrapUpdate()\n\n        def next_task(task: Task, page_info):\n            wrapped_pbar.update(1)\n            return Task(\n                nl.text_reader_task,\n                *task.args, **task.kwargs, page_info=page_info\n            )\n\n        tasks = [\n            TaskChain(\n                Task(\n                    nl.collect_text_reader_page_info_task,\n                    task=t,\n                    task_info=task_info\n                ), next_task=next_task\n            ) for t in ti_tasks\n        ]\n\n        is_sp = False\n\n        if Config.MULTIPROCESSING_MODE == Config.FALSE:\n            is_sp = True\n        elif Config.MULTIPROCESSING_MODE == Config.FORCE:\n            is_sp = False\n        elif Config.MULTIPROCESSING_MODE == Config.AUTO and cpus &lt;= 1 or len(tasks) &lt;= 1:\n            is_sp = True\n\n        if is_sp:\n            res = []\n\n            for task in tasks:\n                page = task.execute()\n\n                res.append(page)\n        else:\n            with TaskManager(cpus, error_mode=\"exception\") as tm:\n                res = tm.execute(tasks, pbar=wrapped_pbar)\n\n        col_path = pid\n        column_dict = {\n            cols: Column(col_path)\n            for cols in ti_import_field_names\n        }\n\n        for res_pages in res:\n            col_map = {\n                n: res_pages[i]\n                for i, n in enumerate(ti_import_field_names)\n            }\n\n            for k, c in column_dict.items():\n                c.pages.append(col_map[k])\n\n        if columns is None:\n            columns = [c[\"name\"] for c in task_columns]\n\n        table_dict = {\n            a[\"name\"]: column_dict[b]\n            for a, b in zip(task_columns, columns)\n        }\n\n        pbar.update(pbar.total - pbar.n)\n\n        table = T(columns=table_dict)\n\n    return table\n</code></pre>"},{"location":"reference/nimlite/#tablite.nimlite.wrap","title":"<code>tablite.nimlite.wrap(str_: str) -&gt; str</code>","text":"Source code in <code>tablite/nimlite.py</code> <pre><code>def wrap(str_: str) -&gt; str:\n    return '\"' + str_.replace('\"', '\\\\\"').replace(\"'\", \"\\\\'\").replace(\"\\n\", \"\\\\n\").replace(\"\\t\", \"\\\\t\") + '\"'\n</code></pre>"},{"location":"reference/nimlite/#tablite.nimlite.column_select","title":"<code>tablite.nimlite.column_select(table: K, cols: list[ColumnSelectorDict], tqdm=_tqdm, TaskManager=TaskManager) -&gt; Tuple[K, K]</code>","text":"Source code in <code>tablite/nimlite.py</code> <pre><code>def column_select(table: K, cols: list[ColumnSelectorDict], tqdm=_tqdm, TaskManager=TaskManager) -&gt; Tuple[K, K]:\n    with tqdm(total=100, desc=\"column select\", bar_format='{desc}: {percentage:.1f}%|{bar}{r_bar}') as pbar:\n        T = type(table)\n        dir_pid = Config.workdir / Config.pid\n\n        col_infos = nl.collect_column_select_info(table, cols, str(dir_pid), pbar)\n\n        columns = col_infos[\"columns\"]\n        page_count = col_infos[\"page_count\"]\n        is_correct_type = col_infos[\"is_correct_type\"]\n        desired_column_map = col_infos[\"desired_column_map\"]\n        original_pages_map = col_infos[\"original_pages_map\"]\n        passed_column_data = col_infos[\"passed_column_data\"]\n        failed_column_data = col_infos[\"failed_column_data\"]\n        res_cols_pass = col_infos[\"res_cols_pass\"]\n        res_cols_fail = col_infos[\"res_cols_fail\"]\n        column_names = col_infos[\"column_names\"]\n        reject_reason_name = col_infos[\"reject_reason_name\"]\n\n        if all(is_correct_type.values()):\n            tbl_pass_columns = {\n                desired_name: table[desired_info[0]]\n                for desired_name, desired_info in desired_column_map.items()\n            }\n\n            tbl_fail_columns = {\n                desired_name: []\n                for desired_name in failed_column_data\n            }\n\n            tbl_pass = T(columns=tbl_pass_columns)\n            tbl_fail = T(columns=tbl_fail_columns)\n\n            return (tbl_pass, tbl_fail)\n\n        task_list_inp = (\n            _collect_cs_info(i, columns, res_cols_pass, res_cols_fail, original_pages_map)\n            for i in range(page_count)\n        )\n\n        page_size = Config.PAGE_SIZE\n\n        tasks = (\n            Task(\n                nl.do_slice_convert, str(dir_pid), page_size, columns, reject_reason_name, res_pass, res_fail, desired_column_map, column_names, is_correct_type\n            )\n            for columns, res_pass, res_fail in task_list_inp\n        )\n\n        cpu_count = max(psutil.cpu_count(), 1)\n\n        if Config.MULTIPROCESSING_MODE == Config.FORCE:\n            is_mp = True\n        elif Config.MULTIPROCESSING_MODE == Config.FALSE:\n            is_mp = False\n        elif Config.MULTIPROCESSING_MODE == Config.AUTO:\n            is_multithreaded = cpu_count &gt; 1\n            is_multipage = page_count &gt; 1\n\n            is_mp = is_multithreaded and is_multipage\n\n        tbl_pass = T({k: [] for k in passed_column_data})\n        tbl_fail = T({k: [] for k in failed_column_data})\n\n        converted = []\n        step_size = 45 / max(page_count, 1)\n\n        if is_mp:\n            class WrapUpdate:\n                def update(self, n):\n                    pbar.update(n * step_size)\n\n            with TaskManager(min(cpu_count, page_count), error_mode=\"exception\") as tm:\n                res = tm.execute(list(tasks), pbar=WrapUpdate())\n\n                converted.extend(res)\n        else:\n            for task in tasks:\n                res = task.f(*task.args, **task.kwargs)\n\n                converted.append(res)\n                pbar.update(step_size)\n\n        def extend_table(table, columns):\n            for (col_name, pg) in columns:\n                table[col_name].pages.append(pg)\n\n        for pg_pass, pg_fail in converted:\n            extend_table(tbl_pass, pg_pass)\n            extend_table(tbl_fail, pg_fail)\n\n        pbar.update(pbar.total - pbar.n)\n\n        return tbl_pass, tbl_fail\n</code></pre>"},{"location":"reference/nimlite/#tablite.nimlite.read_page","title":"<code>tablite.nimlite.read_page(path: Union[str, Path]) -&gt; np.ndarray</code>","text":"Source code in <code>tablite/nimlite.py</code> <pre><code>def read_page(path: Union[str, Path]) -&gt; np.ndarray:\n    return nl.read_page(str(path))\n</code></pre>"},{"location":"reference/nimlite/#tablite.nimlite.repaginate","title":"<code>tablite.nimlite.repaginate(column: Column)</code>","text":"Source code in <code>tablite/nimlite.py</code> <pre><code>def repaginate(column: Column):\n    nl.repaginate(column)\n</code></pre>"},{"location":"reference/nimlite/#tablite.nimlite.nearest_neighbour","title":"<code>tablite.nimlite.nearest_neighbour(T: BaseTable, sources: Union[list[str], None], missing: Union[list, None], targets: Union[list[str], None], tqdm=_tqdm)</code>","text":"Source code in <code>tablite/nimlite.py</code> <pre><code>def nearest_neighbour(T: BaseTable, sources: Union[list[str], None], missing: Union[list, None], targets: Union[list[str], None], tqdm=_tqdm):\n    return nl.nearest_neighbour(T, sources, list(missing), targets, tqdm)\n</code></pre>"},{"location":"reference/nimlite/#tablite.nimlite.filter","title":"<code>tablite.nimlite.filter(table: BaseTable, expressions: list[FilterDict], type: FilterType, tqdm=_tqdm)</code>","text":"Source code in <code>tablite/nimlite.py</code> <pre><code>def filter(table: BaseTable, expressions: list[FilterDict], type: FilterType, tqdm = _tqdm):\n    return nl.filter(table, expressions, type, tqdm)\n</code></pre>"},{"location":"reference/pivots/","title":"Pivots","text":""},{"location":"reference/pivots/#tablite.pivots","title":"<code>tablite.pivots</code>","text":""},{"location":"reference/pivots/#tablite.pivots-classes","title":"Classes","text":""},{"location":"reference/pivots/#tablite.pivots-functions","title":"Functions","text":""},{"location":"reference/pivots/#tablite.pivots.pivot","title":"<code>tablite.pivots.pivot(T, rows, columns, functions, values_as_rows=True, tqdm=_tqdm, pbar=None)</code>","text":"<p>param: rows: column names to keep as rows param: columns: column names to keep as columns param: functions: aggregation functions from the Groupby class as</p> <p>example:</p> <pre><code>&gt;&gt;&gt; t.show()\n+=====+=====+=====+\n|  A  |  B  |  C  |\n| int | int | int |\n+-----+-----+-----+\n|    1|    1|    6|\n|    1|    2|    5|\n|    2|    3|    4|\n|    2|    4|    3|\n|    3|    5|    2|\n|    3|    6|    1|\n|    1|    1|    6|\n|    1|    2|    5|\n|    2|    3|    4|\n|    2|    4|    3|\n|    3|    5|    2|\n|    3|    6|    1|\n+=====+=====+=====+\n\n&gt;&gt;&gt; t2 = t.pivot(rows=['C'], columns=['A'], functions=[('B', gb.sum)])\n&gt;&gt;&gt; t2.show()\n+===+===+========+=====+=====+=====+\n| # | C |function|(A=1)|(A=2)|(A=3)|\n|row|int|  str   |mixed|mixed|mixed|\n+---+---+--------+-----+-----+-----+\n|0  |  6|Sum(B)  |    2|None |None |\n|1  |  5|Sum(B)  |    4|None |None |\n|2  |  4|Sum(B)  |None |    6|None |\n|3  |  3|Sum(B)  |None |    8|None |\n|4  |  2|Sum(B)  |None |None |   10|\n|5  |  1|Sum(B)  |None |None |   12|\n+===+===+========+=====+=====+=====+\n</code></pre> Source code in <code>tablite/pivots.py</code> <pre><code>def pivot(T, rows, columns, functions, values_as_rows=True, tqdm=_tqdm, pbar=None):\n    \"\"\"\n    param: rows: column names to keep as rows\n    param: columns: column names to keep as columns\n    param: functions: aggregation functions from the Groupby class as\n\n    example:\n    ```\n    &gt;&gt;&gt; t.show()\n    +=====+=====+=====+\n    |  A  |  B  |  C  |\n    | int | int | int |\n    +-----+-----+-----+\n    |    1|    1|    6|\n    |    1|    2|    5|\n    |    2|    3|    4|\n    |    2|    4|    3|\n    |    3|    5|    2|\n    |    3|    6|    1|\n    |    1|    1|    6|\n    |    1|    2|    5|\n    |    2|    3|    4|\n    |    2|    4|    3|\n    |    3|    5|    2|\n    |    3|    6|    1|\n    +=====+=====+=====+\n\n    &gt;&gt;&gt; t2 = t.pivot(rows=['C'], columns=['A'], functions=[('B', gb.sum)])\n    &gt;&gt;&gt; t2.show()\n    +===+===+========+=====+=====+=====+\n    | # | C |function|(A=1)|(A=2)|(A=3)|\n    |row|int|  str   |mixed|mixed|mixed|\n    +---+---+--------+-----+-----+-----+\n    |0  |  6|Sum(B)  |    2|None |None |\n    |1  |  5|Sum(B)  |    4|None |None |\n    |2  |  4|Sum(B)  |None |    6|None |\n    |3  |  3|Sum(B)  |None |    8|None |\n    |4  |  2|Sum(B)  |None |None |   10|\n    |5  |  1|Sum(B)  |None |None |   12|\n    +===+===+========+=====+=====+=====+\n    ```\n\n    \"\"\"\n    sub_cls_check(T, BaseTable)\n\n    if isinstance(rows, str):\n        rows = [rows]\n    if not all(isinstance(i, str) for i in rows):\n        raise TypeError(f\"Expected rows as a list of column names, not {[i for i in rows if not isinstance(i,str)]}\")\n\n    if isinstance(columns, str):\n        columns = [columns]\n    if not all(isinstance(i, str) for i in columns):\n        raise TypeError(\n            f\"Expected columns as a list of column names, not {[i for i in columns if not isinstance(i, str)]}\"\n        )\n\n    if not isinstance(values_as_rows, bool):\n        raise TypeError(f\"expected sum_on_rows as boolean, not {type(values_as_rows)}\")\n\n    keys = rows + columns\n    assert isinstance(keys, list)\n\n    extra_steps = 2\n\n    if pbar is None:\n        total = extra_steps\n\n        if len(functions) == 0:\n            total = total + len(keys)\n        else:\n            total = total + len(T)\n\n        pbar = tqdm(total=total, desc=\"pivot\")\n\n    grpby = groupby(T, keys, functions, tqdm=tqdm, pbar=pbar)\n    Constr = type(T)\n\n    if len(grpby) == 0:  # return empty table. This must be a test?\n        pbar.update(extra_steps)\n        return Constr()\n\n    # split keys to determine grid dimensions\n    row_key_index = {}\n    col_key_index = {}\n\n    r = len(rows)\n    c = len(columns)\n    g = len(functions)\n\n    records = defaultdict(dict)\n\n    for row in grpby.rows:\n        row_key = tuple(row[:r])\n        col_key = tuple(row[r : r + c])\n        func_key = tuple(row[r + c :])\n\n        if row_key not in row_key_index:\n            row_key_index[row_key] = len(row_key_index)  # Y\n\n        if col_key not in col_key_index:\n            col_key_index[col_key] = len(col_key_index)  # X\n\n        rix = row_key_index[row_key]\n        cix = col_key_index[col_key]\n        if cix in records:\n            if rix in records[cix]:\n                raise ValueError(\"this should be empty.\")\n        records[cix][rix] = func_key\n\n    pbar.update(1)\n    result = type(T)()\n\n    if values_as_rows:  # ---&gt; leads to more rows.\n        # first create all columns left to right\n\n        n = r + 1  # rows keys + 1 col for function values.\n        cols = [[] for _ in range(n)]\n        for row, ix in row_key_index.items():\n            for col_name, f in functions:\n                cols[-1].append(f\"{f.__name__}({col_name})\")\n                for col_ix, v in enumerate(row):\n                    cols[col_ix].append(v)\n\n        for col_name, values in zip(rows + [\"function\"], cols):\n            col_name = unique_name(col_name, result.columns)\n            result[col_name] = values\n        col_length = len(cols[0])\n        cols.clear()\n\n        # then populate the sparse matrix.\n        for col_key, c in col_key_index.items():\n            col_name = \"(\" + \",\".join([f\"{col_name}={value}\" for col_name, value in zip(columns, col_key)]) + \")\"\n            col_name = unique_name(col_name, result.columns)\n            L = [None for _ in range(col_length)]\n            for r, funcs in records[c].items():\n                for ix, f in enumerate(funcs):\n                    L[g * r + ix] = f\n            result[col_name] = L\n\n    else:  # ---&gt; leads to more columns.\n        n = r\n        cols = [[] for _ in range(n)]\n        for row in row_key_index:\n            for col_ix, v in enumerate(row):\n                cols[col_ix].append(v)  # write key columns.\n\n        for col_name, values in zip(rows, cols):\n            result[col_name] = values\n\n        col_length = len(row_key_index)\n\n        # now populate the sparse matrix.\n        for col_key, c in col_key_index.items():  # select column.\n            cols, names = [], []\n\n            for f, v in zip(functions, func_key):\n                agg_col, func = f\n                terms = \",\".join([agg_col] + [f\"{col_name}={value}\" for col_name, value in zip(columns, col_key)])\n                col_name = f\"{func.__name__}({terms})\"\n                col_name = unique_name(col_name, result.columns)\n                names.append(col_name)\n                cols.append([None for _ in range(col_length)])\n            for r, funcs in records[c].items():\n                for ix, f in enumerate(funcs):\n                    cols[ix][r] = f\n            for name, col in zip(names, cols):\n                result[name] = col\n\n    pbar.update(1)\n\n    return result\n</code></pre>"},{"location":"reference/pivots/#tablite.pivots.transpose","title":"<code>tablite.pivots.transpose(T, tqdm=_tqdm)</code>","text":"<p>performs a CCW matrix rotation of the table.</p> Source code in <code>tablite/pivots.py</code> <pre><code>def transpose(T, tqdm=_tqdm):\n    \"\"\"performs a CCW matrix rotation of the table.\"\"\"\n    sub_cls_check(T, BaseTable)\n\n    if len(T.columns) == 0:\n        return type(T)()\n\n    assert isinstance(T, BaseTable)\n    new = type(T)()\n    L = list(T.columns)\n    new[L[0]] = L[1:]\n    for row in tqdm(T.rows, desc=\"table transpose\", total=len(T)):\n        new[row[0]] = row[1:]\n    return new\n</code></pre>"},{"location":"reference/pivots/#tablite.pivots.pivot_transpose","title":"<code>tablite.pivots.pivot_transpose(T, columns, keep=None, column_name='transpose', value_name='value', tqdm=_tqdm)</code>","text":"<p>Transpose a selection of columns to rows.</p> PARAMETER  DESCRIPTION <code>columns</code> <p>column names to transpose</p> <p> TYPE: <code>list of column names</code> </p> <code>keep</code> <p>column names to keep (repeat)</p> <p> TYPE: <code>list of column names</code> DEFAULT: <code>None</code> </p> RETURNS DESCRIPTION <code>Table</code> <p>with columns transposed to rows</p> Example <p>transpose columns 1,2 and 3 and transpose the remaining columns, except <code>sum</code>.</p> <p>Input:</p> <pre><code>| col1 | col2 | col3 | sun | mon | tue | ... | sat | sum  |\n|------|------|------|-----|-----|-----|-----|-----|------|\n| 1234 | 2345 | 3456 | 456 | 567 |     | ... |     | 1023 |\n| 1244 | 2445 | 4456 |     |   7 |     | ... |     |    7 |\n| ...  |      |      |     |     |     |     |     |      |\n\n&gt;&gt;&gt; t.transpose(keep=[col1, col2, col3], transpose=[sun,mon,tue,wed,thu,fri,sat])`\n\nOutput:\n|col1| col2| col3| transpose| value|\n|----|-----|-----|----------|------|\n|1234| 2345| 3456| sun      |   456|\n|1234| 2345| 3456| mon      |   567|\n|1244| 2445| 4456| mon      |     7|\n</code></pre> Source code in <code>tablite/pivots.py</code> <pre><code>def pivot_transpose(T, columns, keep=None, column_name=\"transpose\", value_name=\"value\", tqdm=_tqdm):\n    \"\"\"Transpose a selection of columns to rows.\n\n    Args:\n        columns (list of column names): column names to transpose\n        keep (list of column names): column names to keep (repeat)\n\n    Returns:\n        Table: with columns transposed to rows\n\n    Example:\n        transpose columns 1,2 and 3 and transpose the remaining columns, except `sum`.\n\n    Input:\n    ```\n    | col1 | col2 | col3 | sun | mon | tue | ... | sat | sum  |\n    |------|------|------|-----|-----|-----|-----|-----|------|\n    | 1234 | 2345 | 3456 | 456 | 567 |     | ... |     | 1023 |\n    | 1244 | 2445 | 4456 |     |   7 |     | ... |     |    7 |\n    | ...  |      |      |     |     |     |     |     |      |\n\n    &gt;&gt;&gt; t.transpose(keep=[col1, col2, col3], transpose=[sun,mon,tue,wed,thu,fri,sat])`\n\n    Output:\n    |col1| col2| col3| transpose| value|\n    |----|-----|-----|----------|------|\n    |1234| 2345| 3456| sun      |   456|\n    |1234| 2345| 3456| mon      |   567|\n    |1244| 2445| 4456| mon      |     7|\n    ```\n\n    \"\"\"\n    sub_cls_check(T, BaseTable)\n\n    if not isinstance(columns, list):\n        raise TypeError\n\n    for i in columns:\n        if not isinstance(i, str):\n            raise TypeError\n        if i not in T.columns:\n            raise ValueError\n        if columns.count(i)&gt;1:\n            raise ValueError(f\"Column {i} appears more than once\")\n\n    if keep is None:\n        keep = []\n    for i in keep:\n        if not isinstance(i, str):\n            raise TypeError\n        if i not in T.columns:\n            raise ValueError\n\n    if column_name in keep + columns:\n        column_name = unique_name(column_name, set_of_names=keep + columns)\n    if value_name in keep + columns + [column_name]:\n        value_name = unique_name(value_name, set_of_names=keep + columns)\n\n    new = type(T)()\n    new.add_columns(*keep + [column_name, value_name])\n    news = {name: [] for name in new.columns}\n\n    n = len(keep)\n\n    with tqdm(total=len(T), desc=\"transpose\", disable=Config.TQDM_DISABLE) as pbar:\n        it = T[keep + columns].rows if len(keep + columns) &gt; 1 else ((v, ) for v in T[keep + columns])\n\n        for ix, row in enumerate(it, start=1):\n            keeps = row[:n]\n            transposes = row[n:]\n\n            for name, value in zip(keep, keeps):\n                news[name].extend([value] * len(transposes))\n            for name, value in zip(columns, transposes):\n                news[column_name].append(name)\n                news[value_name].append(value)\n\n            if ix % Config.SINGLE_PROCESSING_LIMIT == 0:\n                for name, values in news.items():\n                    new[name].extend(values)\n                    values.clear()\n\n            pbar.update(1)\n\n    for name, values in news.items():\n        new[name].extend(np.array(values))\n        values.clear()\n    return new\n</code></pre>"},{"location":"reference/redux/","title":"Redux","text":""},{"location":"reference/redux/#tablite.redux","title":"<code>tablite.redux</code>","text":""},{"location":"reference/redux/#tablite.redux-attributes","title":"Attributes","text":""},{"location":"reference/redux/#tablite.redux-classes","title":"Classes","text":""},{"location":"reference/redux/#tablite.redux-functions","title":"Functions","text":""},{"location":"reference/redux/#tablite.redux.filter_all","title":"<code>tablite.redux.filter_all(T, **kwargs)</code>","text":"<p>returns Table for rows where ALL kwargs match :param kwargs: dictionary with headers and values / boolean callable</p> <p>Examples:</p> <pre><code>t = Table()\nt['a'] = [1,2,3,4]\nt['b'] = [10,20,30,40]\n\ndef f(x):\n    return x == 4\ndef g(x):\n    return x &lt; 20\n\nt2 = t.any( **{\"a\":f, \"b\":g})\nassert [r for r in t2.rows] == [[1, 10], [4, 40]]\n\nt2 = t.any(a=f,b=g)\nassert [r for r in t2.rows] == [[1, 10], [4, 40]]\n\ndef h(x):\n    return x&gt;=2\n\ndef i(x):\n    return x&lt;=30\n\nt2 = t.all(a=h,b=i)\nassert [r for r in t2.rows] == [[2,20], [3, 30]]\n</code></pre> Source code in <code>tablite/redux.py</code> <pre><code>def filter_all(T, **kwargs):\n    \"\"\"\n    returns Table for rows where ALL kwargs match\n    :param kwargs: dictionary with headers and values / boolean callable\n\n    Examples:\n\n        t = Table()\n        t['a'] = [1,2,3,4]\n        t['b'] = [10,20,30,40]\n\n        def f(x):\n            return x == 4\n        def g(x):\n            return x &lt; 20\n\n        t2 = t.any( **{\"a\":f, \"b\":g})\n        assert [r for r in t2.rows] == [[1, 10], [4, 40]]\n\n        t2 = t.any(a=f,b=g)\n        assert [r for r in t2.rows] == [[1, 10], [4, 40]]\n\n        def h(x):\n            return x&gt;=2\n\n        def i(x):\n            return x&lt;=30\n\n        t2 = t.all(a=h,b=i)\n        assert [r for r in t2.rows] == [[2,20], [3, 30]]\n\n\n    \"\"\"\n    sub_cls_check(T, BaseTable)\n\n    if not isinstance(kwargs, dict):\n        raise TypeError(\"did you forget to add the ** in front of your dict?\")\n    if not all([k in T.columns for k in kwargs]):\n        raise ValueError(f\"Unknown column(s): {[k for k in kwargs if k not in T.columns]}\")\n\n    mask = np.full((len(T),), True)\n    for k, v in kwargs.items():\n        col = T[k]\n        for start, end, page in col.iter_by_page():\n            data = page.get()\n            if callable(v):\n                vf = np.frompyfunc(v, 1, 1)\n                mask[start:end] = mask[start:end] &amp; np.apply_along_axis(vf, 0, data)\n            else:\n                mask[start:end] = mask[start:end] &amp; (data == v)\n\n    return _compress_one(T, mask)\n</code></pre>"},{"location":"reference/redux/#tablite.redux.drop","title":"<code>tablite.redux.drop(T, *args)</code>","text":"<p>drops all rows that contain args</p> PARAMETER  DESCRIPTION <code>T</code> <p> TYPE: <code>Table</code> </p> Source code in <code>tablite/redux.py</code> <pre><code>def drop(T, *args):\n    \"\"\"drops all rows that contain args\n\n    Args:\n        T (Table):\n    \"\"\"\n    sub_cls_check(T, BaseTable)\n    mask = np.full((len(T),), False)\n    for name in T.columns:\n        col = T[name]\n        for start, end, page in col.iter_by_page():\n            data = page.get()\n            for arg in args:\n                mask[start:end] = mask[start:end] | (data == arg)\n\n    mask = np.invert(mask)\n    return _compress_one(T, mask)\n</code></pre>"},{"location":"reference/redux/#tablite.redux.filter_any","title":"<code>tablite.redux.filter_any(T, **kwargs)</code>","text":"<p>returns Table for rows where ANY kwargs match :param kwargs: dictionary with headers and values / boolean callable</p> Source code in <code>tablite/redux.py</code> <pre><code>def filter_any(T, **kwargs):\n    \"\"\"\n    returns Table for rows where ANY kwargs match\n    :param kwargs: dictionary with headers and values / boolean callable\n    \"\"\"\n    sub_cls_check(T, BaseTable)\n    if not isinstance(kwargs, dict):\n        raise TypeError(\"did you forget to add the ** in front of your dict?\")\n\n    mask = np.full((len(T),), False)\n    for k, v in kwargs.items():\n        col = T[k]\n        for start, end, page in col.iter_by_page():\n            data = page.get()\n            if callable(v):\n                vf = np.frompyfunc(v, 1, 1)\n                mask[start:end] = mask[start:end] | np.apply_along_axis(vf, 0, data)\n            else:\n                mask[start:end] = mask[start:end] | (v == data)\n\n    return _compress_one(T, mask)\n</code></pre>"},{"location":"reference/redux/#tablite.redux.filter","title":"<code>tablite.redux.filter(T, expressions, filter_type='all', tqdm=_tqdm)</code>","text":"<p>filters table</p> PARAMETER  DESCRIPTION <code>T</code> <p>Table.</p> <p> TYPE: <code>Table subclass</code> </p> <code>expressions</code> <p>str:     filters based on an expression, such as:     \"all((A==B, C!=4, 200&lt;D))\"     which is interpreted using python's compiler to:</p> <pre><code>def _f(A,B,C,D):\n    return all((A==B, C!=4, 200&lt;D))\n</code></pre> <p>list of dicts: (example):</p> <p>L = [     {'column1':'A', 'criteria': \"==\", 'column2': 'B'},     {'column1':'C', 'criteria': \"!=\", \"value2\": '4'},     {'value1': 200, 'criteria': \"&lt;\", column2: 'D' } ]</p> <p> TYPE: <code>list or str</code> </p> <code>accepted</code> <p>'column1', 'column2', 'criteria', 'value1', 'value2'</p> <p> TYPE: <code>dictionary keys</code> </p> <code>filter_type</code> <p>Ignored if expressions is str. 'all' or 'any'. Defaults to \"all\".</p> <p> TYPE: <code>str</code> DEFAULT: <code>'all'</code> </p> <code>tqdm</code> <p>progressbar. Defaults to _tqdm.</p> <p> TYPE: <code>tqdm</code> DEFAULT: <code>tqdm</code> </p> RETURNS DESCRIPTION <code>2xTables</code> <p>trues, falses</p> Source code in <code>tablite/redux.py</code> <pre><code>def filter(T, expressions, filter_type=\"all\", tqdm=_tqdm):\n    \"\"\"filters table\n\n\n    Args:\n        T (Table subclass): Table.\n        expressions (list or str):\n            str:\n                filters based on an expression, such as:\n                \"all((A==B, C!=4, 200&lt;D))\"\n                which is interpreted using python's compiler to:\n\n                def _f(A,B,C,D):\n                    return all((A==B, C!=4, 200&lt;D))\n\n            list of dicts: (example):\n\n            L = [\n                {'column1':'A', 'criteria': \"==\", 'column2': 'B'},\n                {'column1':'C', 'criteria': \"!=\", \"value2\": '4'},\n                {'value1': 200, 'criteria': \"&lt;\", column2: 'D' }\n            ]\n\n        accepted dictionary keys: 'column1', 'column2', 'criteria', 'value1', 'value2'\n\n        filter_type (str, optional): Ignored if expressions is str.\n            'all' or 'any'. Defaults to \"all\".\n        tqdm (tqdm, optional): progressbar. Defaults to _tqdm.\n\n    Returns:\n        2xTables: trues, falses\n    \"\"\"\n    # determine method\n    sub_cls_check(T, BaseTable)\n    if len(T) == 0:\n        return T.copy(), T.copy()\n\n    if isinstance(expressions, str):\n        with tqdm(desc=\"filter\", total=20) as pbar:\n            # TODO: make parser for expressions and use the nim implement\n            mask = _filter_using_expression(T, expressions)\n            pbar.update(10)\n            res = _compress_both(T, mask, pbar=pbar)\n            pbar.update(pbar.total - pbar.n)\n    elif isinstance(expressions, list):\n        return _filter_using_list_of_dicts(T, expressions, filter_type, tqdm)\n    else:\n        raise TypeError\n        # create new tables\n\n    return res\n</code></pre>"},{"location":"reference/reindex/","title":"Reindex","text":""},{"location":"reference/reindex/#tablite.reindex","title":"<code>tablite.reindex</code>","text":""},{"location":"reference/reindex/#tablite.reindex-classes","title":"Classes","text":""},{"location":"reference/reindex/#tablite.reindex-functions","title":"Functions","text":""},{"location":"reference/reindex/#tablite.reindex.reindex","title":"<code>tablite.reindex.reindex(T, index, names=None, tqdm=_tqdm, pbar=None)</code>","text":"<p>Constant Memory helper for reindexing pages.</p> <p>Memory usage is set by datatype and Config.PAGE_SIZE</p> PARAMETER  DESCRIPTION <code>T</code> <p>subclass of Table</p> <p> TYPE: <code>Table</code> </p> <code>index</code> <p>int64.</p> <p> TYPE: <code>array</code> </p> <code>names</code> <p>list of names from T to reindex.</p> <p> TYPE: <code>(list, str)</code> DEFAULT: <code>None</code> </p> <code>tqdm</code> <p>Defaults to _tqdm.</p> <p> TYPE: <code>tqdm</code> DEFAULT: <code>tqdm</code> </p> <code>pbar</code> <p>Defaults to None.</p> <p> TYPE: <code>pbar</code> DEFAULT: <code>None</code> </p> RETURNS DESCRIPTION <code>_type_</code> <p>description</p> Source code in <code>tablite/reindex.py</code> <pre><code>def reindex(T, index, names=None, tqdm=_tqdm, pbar=None):\n    \"\"\"Constant Memory helper for reindexing pages.\n\n    Memory usage is set by datatype and Config.PAGE_SIZE\n\n    Args:\n        T (Table): subclass of Table\n        index (np.array): int64.\n        names (list, str): list of names from T to reindex.\n        tqdm (tqdm, optional): Defaults to _tqdm.\n        pbar (pbar, optional): Defaults to None.\n\n    Returns:\n        _type_: _description_\n    \"\"\"\n    if names is None:\n        names = list(T.columns.keys())\n\n    if pbar is None:\n        total = len(names)\n        pbar = tqdm(total=total, desc=\"join\", disable=Config.TQDM_DISABLE)\n\n    sub_cls_check(T, BaseTable)\n    cls = type(T)\n    result = cls()\n    for name in names:\n        result.add_column(name)\n        col = result[name]\n\n        for start, end in Config.page_steps(len(index)):\n            indices = index[start:end]\n            values = T[name].get_by_indices(indices)\n            # in these values, the index of -1 will be wrong.\n            # so if there is any -1 in the indices, they will\n            # have to be replaced with Nones\n            mask = indices == -1\n            if np.any(mask):\n                nones = np.full(index.shape, fill_value=None)\n                values = np.where(mask, nones, values)\n            col.extend(values)\n        pbar.update(1)\n\n    return result\n</code></pre>"},{"location":"reference/sort_utils/","title":"Sort utils","text":""},{"location":"reference/sort_utils/#tablite.sort_utils","title":"<code>tablite.sort_utils</code>","text":""},{"location":"reference/sort_utils/#tablite.sort_utils-attributes","title":"Attributes","text":""},{"location":"reference/sort_utils/#tablite.sort_utils.uca_collator","title":"<code>tablite.sort_utils.uca_collator = Collator()</code>  <code>module-attribute</code>","text":""},{"location":"reference/sort_utils/#tablite.sort_utils.modes","title":"<code>tablite.sort_utils.modes = {'alphanumeric': text_sort, 'unix': unix_sort, 'excel': excel_sort}</code>  <code>module-attribute</code>","text":""},{"location":"reference/sort_utils/#tablite.sort_utils-classes","title":"Classes","text":""},{"location":"reference/sort_utils/#tablite.sort_utils.HashDict","title":"<code>tablite.sort_utils.HashDict</code>","text":"<p>             Bases: <code>dict</code></p> <p>This class is just a nicity syntatic sugar for debugging. Function identically to regular dictionary, just uses tupled key.</p>"},{"location":"reference/sort_utils/#tablite.sort_utils.HashDict-functions","title":"Functions","text":""},{"location":"reference/sort_utils/#tablite.sort_utils.HashDict.items","title":"<code>tablite.sort_utils.HashDict.items()</code>","text":"Source code in <code>tablite/sort_utils.py</code> <pre><code>def items(self):\n    return [(k, v) for (_, k), v in super().items()]\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils.HashDict.keys","title":"<code>tablite.sort_utils.HashDict.keys()</code>","text":"Source code in <code>tablite/sort_utils.py</code> <pre><code>def keys(self):\n    return [k for (_, k) in super().keys()]\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils.HashDict.__iter__","title":"<code>tablite.sort_utils.HashDict.__iter__() -&gt; Iterator</code>","text":"Source code in <code>tablite/sort_utils.py</code> <pre><code>def __iter__(self) -&gt; Iterator:\n    return (k for (_, k) in super().keys())\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils.HashDict.__getitem__","title":"<code>tablite.sort_utils.HashDict.__getitem__(key)</code>","text":"Source code in <code>tablite/sort_utils.py</code> <pre><code>def __getitem__(self, key):\n    return super().__getitem__(self._get_hash(key))\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils.HashDict.__setitem__","title":"<code>tablite.sort_utils.HashDict.__setitem__(key, value)</code>","text":"Source code in <code>tablite/sort_utils.py</code> <pre><code>def __setitem__(self, key, value):\n    return super().__setitem__(self._get_hash(key), value)\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils.HashDict.__contains__","title":"<code>tablite.sort_utils.HashDict.__contains__(key) -&gt; bool</code>","text":"Source code in <code>tablite/sort_utils.py</code> <pre><code>def __contains__(self, key) -&gt; bool:\n    return super().__contains__(self._get_hash(key))\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils.HashDict.__delitem__","title":"<code>tablite.sort_utils.HashDict.__delitem__(key)</code>","text":"Source code in <code>tablite/sort_utils.py</code> <pre><code>def __delitem__(self, key):\n    return super().__delitem__(self._get_hash(key))\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils.HashDict.__repr__","title":"<code>tablite.sort_utils.HashDict.__repr__() -&gt; str</code>","text":"Source code in <code>tablite/sort_utils.py</code> <pre><code>def __repr__(self) -&gt; str:\n    return '{' + \", \".join([f\"{k}: {v}\" for k, v in self.items()]) + '}'\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils.HashDict.__str__","title":"<code>tablite.sort_utils.HashDict.__str__() -&gt; str</code>","text":"Source code in <code>tablite/sort_utils.py</code> <pre><code>def __str__(self) -&gt; str:\n    return repr(self)\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils-functions","title":"Functions","text":""},{"location":"reference/sort_utils/#tablite.sort_utils.text_sort","title":"<code>tablite.sort_utils.text_sort(values, reverse=False)</code>","text":"<p>Sorts everything as text.</p> Source code in <code>tablite/sort_utils.py</code> <pre><code>def text_sort(values, reverse=False):\n    \"\"\"\n    Sorts everything as text.\n    \"\"\"\n    text = {str(i): i for i in values}\n    L = list(text.keys())\n    L.sort(key=uca_collator.sort_key, reverse=reverse)\n    d = {text[value]: ix for ix, value in enumerate(L)}\n    return d\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils.unix_sort","title":"<code>tablite.sort_utils.unix_sort(values, reverse=False)</code>","text":"<p>Unix sortation sorts by the following order:</p> <p>| rank | type      | value                                      | +------+-----------+--------------------------------------------+ |   0  | None      | floating point -infinite                   | |   1  | bool      | 0 as False, 1 as True                      | |   2  | int       | as numeric value                           | |   2  | float     | as numeric value                           | |   3  | time      | \u03c4 * seconds into the day / (24 * 60 * 60)  | |   4  | date      | as integer days since 1970/1/1             | |   5  | datetime  | as float using date (int) + time (decimal) | |   6  | timedelta | as float using date (int) + time (decimal) | |   7  | str       | using unicode                              | +------+-----------+--------------------------------------------+</p> <p>\u03c4 = 2 * \u03c0</p> Source code in <code>tablite/sort_utils.py</code> <pre><code>def unix_sort(values, reverse=False):\n    \"\"\"\n    Unix sortation sorts by the following order:\n\n    | rank | type      | value                                      |\n    +------+-----------+--------------------------------------------+\n    |   0  | None      | floating point -infinite                   |\n    |   1  | bool      | 0 as False, 1 as True                      |\n    |   2  | int       | as numeric value                           |\n    |   2  | float     | as numeric value                           |\n    |   3  | time      | \u03c4 * seconds into the day / (24 * 60 * 60)  |\n    |   4  | date      | as integer days since 1970/1/1             |\n    |   5  | datetime  | as float using date (int) + time (decimal) |\n    |   6  | timedelta | as float using date (int) + time (decimal) |\n    |   7  | str       | using unicode                              |\n    +------+-----------+--------------------------------------------+\n\n    \u03c4 = 2 * \u03c0\n\n    \"\"\"\n    text, non_text = [], []\n\n    # L = []\n    # text = [i for i in values if isinstance(i, str)]\n    # text.sort(key=uca_collator.sort_key, reverse=reverse)\n    # text_code = _unix_typecodes[str]\n    # L = [(text_code, ix, v) for ix, v in enumerate(text)]\n\n    for value in values:\n        if isinstance(value, str):\n            text.append(value)\n        else:\n            t = type(value)\n            TC = _unix_typecodes[t]\n            tf = _unix_value_function[t]\n            VC = tf(value)\n            non_text.append((TC, VC, value))\n    non_text.sort(reverse=reverse)\n\n    text.sort(key=uca_collator.sort_key, reverse=reverse)\n    text_code = _unix_typecodes[str]\n    text = [(text_code, ix, v) for ix, v in enumerate(text)]\n\n    d = HashDict()\n    L = non_text + text\n    for ix, (_, _, value) in enumerate(L):\n        d[value] = ix\n    return d\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils.excel_sort","title":"<code>tablite.sort_utils.excel_sort(values, reverse=False)</code>","text":"<p>Excel sortation sorts by the following order:</p> <p>| rank | type      | value                                      | +------+-----------+--------------------------------------------+ |   1  | int       | as numeric value                           | |   1  | float     | as numeric value                           | |   1  | time      | as seconds into the day / (24 * 60 * 60)   | |   1  | date      | as integer days since 1900/1/1             | |   1  | datetime  | as float using date (int) + time (decimal) | |  (1)*| timedelta | as float using date (int) + time (decimal) | |   2  | str       | using unicode                              | |   3  | bool      | 0 as False, 1 as True                      | |   4  | None      | floating point infinite.                   | +------+-----------+--------------------------------------------+</p> <ul> <li>Excel doesn't have timedelta.</li> </ul> Source code in <code>tablite/sort_utils.py</code> <pre><code>def excel_sort(values, reverse=False):\n    \"\"\"\n    Excel sortation sorts by the following order:\n\n    | rank | type      | value                                      |\n    +------+-----------+--------------------------------------------+\n    |   1  | int       | as numeric value                           |\n    |   1  | float     | as numeric value                           |\n    |   1  | time      | as seconds into the day / (24 * 60 * 60)   |\n    |   1  | date      | as integer days since 1900/1/1             |\n    |   1  | datetime  | as float using date (int) + time (decimal) |\n    |  (1)*| timedelta | as float using date (int) + time (decimal) |\n    |   2  | str       | using unicode                              |\n    |   3  | bool      | 0 as False, 1 as True                      |\n    |   4  | None      | floating point infinite.                   |\n    +------+-----------+--------------------------------------------+\n\n    * Excel doesn't have timedelta.\n    \"\"\"\n\n    def tup(TC, value):\n        return (TC, _excel_value_function[t](value), value)\n\n    text, numeric, booles, nones = [], [], [], []\n    for value in values:\n        t = type(value)\n        TC = _excel_typecodes[t]\n\n        if TC == 0:\n            numeric.append(tup(TC, value))\n        elif TC == 1:\n            text.append(value)  # text is processed later.\n        elif TC == 2:\n            booles.append(tup(TC, value))\n        elif TC == 3:\n            booles.append(tup(TC, value))\n        else:\n            raise TypeError(f\"no typecode for {value}\")\n\n    if text:\n        text.sort(key=uca_collator.sort_key, reverse=reverse)\n        text = [(2, ix, v) for ix, v in enumerate(text)]\n\n    numeric.sort(reverse=reverse)\n    booles.sort(reverse=reverse)\n    nones.sort(reverse=reverse)\n\n    if reverse:\n        L = nones + booles + text + numeric\n    else:\n        L = numeric + text + booles + nones\n    d = {value: ix for ix, (_, _, value) in enumerate(L)}\n    return d\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils.rank","title":"<code>tablite.sort_utils.rank(values, reverse, mode)</code>","text":"<p>values: list of values to sort. reverse: bool mode: as 'text', as 'numeric' or as 'excel' return: dict: d[value] = rank</p> Source code in <code>tablite/sort_utils.py</code> <pre><code>def rank(values, reverse, mode):\n    \"\"\"\n    values: list of values to sort.\n    reverse: bool\n    mode: as 'text', as 'numeric' or as 'excel'\n    return: dict: d[value] = rank\n    \"\"\"\n    if mode not in modes:\n        raise ValueError(f\"{mode} not in list of modes: {list(modes)}\")\n    f = modes.get(mode)\n    return f(values, reverse)\n</code></pre>"},{"location":"reference/sortation/","title":"Sortation","text":""},{"location":"reference/sortation/#tablite.sortation","title":"<code>tablite.sortation</code>","text":""},{"location":"reference/sortation/#tablite.sortation-attributes","title":"Attributes","text":""},{"location":"reference/sortation/#tablite.sortation-classes","title":"Classes","text":""},{"location":"reference/sortation/#tablite.sortation-functions","title":"Functions","text":""},{"location":"reference/sortation/#tablite.sortation.sort_index","title":"<code>tablite.sortation.sort_index(T, mapping, sort_mode='excel', tqdm=_tqdm, pbar=None)</code>","text":"<p>helper for methods <code>sort</code> and <code>is_sorted</code></p> <p>param: sort_mode: str: \"alphanumeric\", \"unix\", or, \"excel\" (default) param: **kwargs: sort criteria. See Table.sort()</p> Source code in <code>tablite/sortation.py</code> <pre><code>def sort_index(T, mapping, sort_mode=\"excel\", tqdm=_tqdm, pbar=None):\n    \"\"\"\n    helper for methods `sort` and `is_sorted`\n\n    param: sort_mode: str: \"alphanumeric\", \"unix\", or, \"excel\" (default)\n    param: **kwargs: sort criteria. See Table.sort()\n    \"\"\"\n\n    sub_cls_check(T, BaseTable)\n\n    if not isinstance(mapping, dict) or not mapping:\n        raise TypeError(\"Expected mapping (dict)?\")\n\n    for k, v in mapping.items():\n        if k not in T.columns:\n            raise ValueError(f\"no column {k}\")\n        if not isinstance(v, bool):\n            raise ValueError(f\"{k} was mapped to {v} - a non-boolean\")\n\n    if sort_mode not in sort_modes:\n        raise ValueError(f\"{sort_mode} not in list of sort_modes: {list(sort_modes)}\")\n\n    rank = {i: tuple() for i in range(len(T))}  # create index and empty tuple for sortation.\n\n    _pbar = tqdm(total=len(mapping.items()), desc=\"creating sort index\") if pbar is None else pbar\n\n    for key, reverse in mapping.items():\n        col = T[key][:]\n        ranks = sort_rank(values=[numpy_to_python(v) for v in multitype_set(col)], reverse=reverse, mode=sort_mode)\n        assert isinstance(ranks, dict)\n        for ix, v in enumerate(col):\n            v2 = numpy_to_python(v)\n            rank[ix] += (ranks[v2],)  # add tuple for each sortation level.\n\n        _pbar.update(1)\n\n    del col\n    del ranks\n\n    new_order = [(r, i) for i, r in rank.items()]  # tuples are listed and sort...\n    del rank  # free memory.\n\n    new_order.sort()\n    sorted_index = [i for _, i in new_order]  # new index is extracted.\n    new_order.clear()\n    return np.array(sorted_index, dtype=np.int64)\n</code></pre>"},{"location":"reference/sortation/#tablite.sortation.reindex","title":"<code>tablite.sortation.reindex(T, index)</code>","text":"<p>index: list of integers that declare sort order.</p> <p>Examples:</p> <pre><code>Table:  ['a','b','c','d','e','f','g','h']\nindex:  [0,2,4,6]\nresult: ['b','d','f','h']\n\nTable:  ['a','b','c','d','e','f','g','h']\nindex:  [0,2,4,6,1,3,5,7]\nresult: ['a','c','e','g','b','d','f','h']\n</code></pre> Source code in <code>tablite/sortation.py</code> <pre><code>def reindex(T, index):\n    \"\"\"\n    index: list of integers that declare sort order.\n\n    Examples:\n\n        Table:  ['a','b','c','d','e','f','g','h']\n        index:  [0,2,4,6]\n        result: ['b','d','f','h']\n\n        Table:  ['a','b','c','d','e','f','g','h']\n        index:  [0,2,4,6,1,3,5,7]\n        result: ['a','c','e','g','b','d','f','h']\n\n    \"\"\"\n    sub_cls_check(T, BaseTable)\n    if isinstance(index, list):\n        index = np.array(index, dtype=int)\n    type_check(index, np.ndarray)\n    if max(index) &gt;= len(T):\n        raise IndexError(\"index out of range: max(index) &gt; len(self)\")\n    if min(index) &lt; -len(T):\n        raise IndexError(\"index out of range: min(index) &lt; -len(self)\")\n\n    fields = len(T) * len(T.columns)\n    m = select_processing_method(fields, _reindex, _mp_reindex)\n    return m(T, index)\n</code></pre>"},{"location":"reference/sortation/#tablite.sortation.sort","title":"<code>tablite.sortation.sort(T, mapping, sort_mode='excel', tqdm=_tqdm, pbar: _tqdm = None)</code>","text":"<p>Perform multi-pass sorting with precedence given order of column names. sort_mode: str: \"alphanumeric\", \"unix\", or, \"excel\" kwargs:     keys: columns,     values: 'reverse' as boolean.</p> <p>examples: Table.sort('A'=False) means sort by 'A' in ascending order. Table.sort('A'=True, 'B'=False) means sort 'A' in descending order, then (2nd priority) sort B in ascending order.</p> Source code in <code>tablite/sortation.py</code> <pre><code>def sort(T, mapping, sort_mode=\"excel\", tqdm=_tqdm, pbar: _tqdm = None):\n    \"\"\"Perform multi-pass sorting with precedence given order of column names.\n    sort_mode: str: \"alphanumeric\", \"unix\", or, \"excel\"\n    kwargs:\n        keys: columns,\n        values: 'reverse' as boolean.\n\n    examples:\n    Table.sort('A'=False) means sort by 'A' in ascending order.\n    Table.sort('A'=True, 'B'=False) means sort 'A' in descending order, then (2nd priority)\n    sort B in ascending order.\n    \"\"\"\n    sub_cls_check(T, BaseTable)\n\n    index = sort_index(T, mapping, sort_mode=sort_mode, tqdm=_tqdm, pbar=pbar)\n    m = select_processing_method(len(T) * len(T.columns), _sp_reindex, _mp_reindex)\n    return m(T, index, tqdm=tqdm, pbar=pbar)\n</code></pre>"},{"location":"reference/sortation/#tablite.sortation.is_sorted","title":"<code>tablite.sortation.is_sorted(T, mapping, sort_mode='excel')</code>","text":"<p>Performs multi-pass sorting check with precedence given order of column names.</p> PARAMETER  DESCRIPTION <code>mapping</code> <p>sort criteria. See Table.sort()</p> <p> </p> RETURNS DESCRIPTION <p>bool</p> Source code in <code>tablite/sortation.py</code> <pre><code>def is_sorted(T, mapping, sort_mode=\"excel\"):\n    \"\"\"Performs multi-pass sorting check with precedence given order of column names.\n\n    Args:\n        mapping: sort criteria. See Table.sort()\n        sort_mode = sort mode. See Table.sort()\n\n    Returns:\n        bool\n    \"\"\"\n    index = sort_index(T, mapping, sort_mode=sort_mode)\n    match = np.arange(len(T))\n    return np.all(index == match)\n</code></pre>"},{"location":"reference/tools/","title":"Tools","text":""},{"location":"reference/tools/#tablite.tools","title":"<code>tablite.tools</code>","text":""},{"location":"reference/tools/#tablite.tools-attributes","title":"Attributes","text":""},{"location":"reference/tools/#tablite.tools.guess","title":"<code>tablite.tools.guess = DataTypes.guess</code>  <code>module-attribute</code>","text":""},{"location":"reference/tools/#tablite.tools.xround","title":"<code>tablite.tools.xround = DataTypes.round</code>  <code>module-attribute</code>","text":""},{"location":"reference/tools/#tablite.tools-classes","title":"Classes","text":""},{"location":"reference/tools/#tablite.tools-functions","title":"Functions","text":""},{"location":"reference/tools/#tablite.tools.head","title":"<code>tablite.tools.head(path, linecount=5, delimiter=None)</code>","text":"<p>Gets the head of any supported file format.</p> Source code in <code>tablite/tools.py</code> <pre><code>def head(path, linecount=5, delimiter=None):\n    \"\"\"\n    Gets the head of any supported file format.\n    \"\"\"\n    return get_headers(path, linecount=linecount, delimiter=delimiter)\n</code></pre>"},{"location":"reference/utils/","title":"Utils","text":""},{"location":"reference/utils/#tablite.utils","title":"<code>tablite.utils</code>","text":""},{"location":"reference/utils/#tablite.utils-attributes","title":"Attributes","text":""},{"location":"reference/utils/#tablite.utils.letters","title":"<code>tablite.utils.letters = string.ascii_lowercase + string.digits</code>  <code>module-attribute</code>","text":""},{"location":"reference/utils/#tablite.utils.NoneType","title":"<code>tablite.utils.NoneType = type(None)</code>  <code>module-attribute</code>","text":""},{"location":"reference/utils/#tablite.utils.required_keys","title":"<code>tablite.utils.required_keys = {'min', 'max', 'mean', 'median', 'stdev', 'mode', 'distinct', 'iqr_low', 'iqr_high', 'iqr', 'sum', 'summary type', 'histogram'}</code>  <code>module-attribute</code>","text":""},{"location":"reference/utils/#tablite.utils.summary_methods","title":"<code>tablite.utils.summary_methods = {bool: _boolean_statistics_summary, int: _numeric_statistics_summary, float: _numeric_statistics_summary, str: _string_statistics_summary, date: _date_statistics_summary, datetime: _datetime_statistics_summary, time: _time_statistics_summary, timedelta: _timedelta_statistics_summary, type(None): _none_type_summary}</code>  <code>module-attribute</code>","text":""},{"location":"reference/utils/#tablite.utils-classes","title":"Classes","text":""},{"location":"reference/utils/#tablite.utils-functions","title":"Functions","text":""},{"location":"reference/utils/#tablite.utils.generate_random_string","title":"<code>tablite.utils.generate_random_string(len)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def generate_random_string(len):\n    return \"\".join(random.choice(letters) for i in range(len))\n</code></pre>"},{"location":"reference/utils/#tablite.utils.type_check","title":"<code>tablite.utils.type_check(var, kind)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def type_check(var, kind):\n    if not isinstance(var, kind):\n        raise TypeError(f\"Expected {kind}, not {type(var)}\")\n</code></pre>"},{"location":"reference/utils/#tablite.utils.sub_cls_check","title":"<code>tablite.utils.sub_cls_check(c, kind)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def sub_cls_check(c, kind):\n    if not issubclass(type(c), kind):\n        raise TypeError(f\"Expected {kind}, not {type(c)}\")\n</code></pre>"},{"location":"reference/utils/#tablite.utils.name_check","title":"<code>tablite.utils.name_check(options, *names)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def name_check(options, *names):\n    for n in names:\n        if n not in options:\n            raise ValueError(f\"{n} not in {options}\")\n</code></pre>"},{"location":"reference/utils/#tablite.utils.unique_name","title":"<code>tablite.utils.unique_name(wanted_name, set_of_names)</code>","text":"<p>returns a wanted_name as wanted_name_i given a list of names which guarantees unique naming.</p> Source code in <code>tablite/utils.py</code> <pre><code>def unique_name(wanted_name, set_of_names):\n    \"\"\"\n    returns a wanted_name as wanted_name_i given a list of names\n    which guarantees unique naming.\n    \"\"\"\n    if not isinstance(set_of_names, set):\n        set_of_names = set(set_of_names)\n    name, i = wanted_name, 1\n    while name in set_of_names:\n        name = f\"{wanted_name}_{i}\"\n        i += 1\n    return name\n</code></pre>"},{"location":"reference/utils/#tablite.utils.expression_interpreter","title":"<code>tablite.utils.expression_interpreter(expression, columns)</code>","text":"<p>Interprets valid expressions such as:</p> <pre><code>\"all((A==B, C!=4, 200&lt;D))\"\n</code></pre> as <p>def _f(A,B,C,D):     return all((A==B, C!=4, 200&lt;D))</p> <p>using python's compiler.</p> Source code in <code>tablite/utils.py</code> <pre><code>def expression_interpreter(expression, columns):\n    \"\"\"\n    Interprets valid expressions such as:\n\n        \"all((A==B, C!=4, 200&lt;D))\"\n\n    as:\n        def _f(A,B,C,D):\n            return all((A==B, C!=4, 200&lt;D))\n\n    using python's compiler.\n    \"\"\"\n    if not isinstance(expression, str):\n        raise TypeError(f\"`{expression}` is not a str\")\n    if not isinstance(columns, list):\n        raise TypeError\n    if not all(isinstance(i, str) for i in columns):\n        raise TypeError\n\n    req_columns = \", \".join(i for i in columns if i in expression)\n    script = f\"def f({req_columns}):\\n    return {expression}\"\n    tree = ast.parse(script)\n    code = compile(tree, filename=\"blah\", mode=\"exec\")\n    namespace = {}\n    exec(code, namespace)\n    f = namespace[\"f\"]\n    if not callable(f):\n        raise ValueError(f\"The expression could not be parse: {expression}\")\n    return f\n</code></pre>"},{"location":"reference/utils/#tablite.utils.intercept","title":"<code>tablite.utils.intercept(A, B)</code>","text":"<p>Enables calculation of the intercept of two range objects. Used to determine if a datablock contains a slice.</p> PARAMETER  DESCRIPTION <code>A</code> <p>range</p> <p> </p> <code>B</code> <p>range</p> <p> </p> RETURNS DESCRIPTION <code>range</code> <p>The intercept of ranges A and B.</p> Source code in <code>tablite/utils.py</code> <pre><code>def intercept(A, B):\n    \"\"\"Enables calculation of the intercept of two range objects.\n    Used to determine if a datablock contains a slice.\n\n    Args:\n        A: range\n        B: range\n\n    Returns:\n        range: The intercept of ranges A and B.\n    \"\"\"\n    type_check(A, range)\n    type_check(B, range)\n\n    if A.step &lt; 1:\n        A = range(A.stop + 1, A.start + 1, 1)\n    if B.step &lt; 1:\n        B = range(B.stop + 1, B.start + 1, 1)\n\n    if len(A) == 0:\n        return range(0)\n    if len(B) == 0:\n        return range(0)\n\n    if A.stop &lt;= B.start:\n        return range(0)\n    if A.start &gt;= B.stop:\n        return range(0)\n\n    if A.start &lt;= B.start:\n        if A.stop &lt;= B.stop:\n            start, end = B.start, A.stop\n        elif A.stop &gt; B.stop:\n            start, end = B.start, B.stop\n        else:\n            raise ValueError(\"bad logic\")\n    elif A.start &lt; B.stop:\n        if A.stop &lt;= B.stop:\n            start, end = A.start, A.stop\n        elif A.stop &gt; B.stop:\n            start, end = A.start, B.stop\n        else:\n            raise ValueError(\"bad logic\")\n    else:\n        raise ValueError(\"bad logic\")\n\n    a_steps = math.ceil((start - A.start) / A.step)\n    a_start = (a_steps * A.step) + A.start\n\n    b_steps = math.ceil((start - B.start) / B.step)\n    b_start = (b_steps * B.step) + B.start\n\n    if A.step == 1 or B.step == 1:\n        start = max(a_start, b_start)\n        step = max(A.step, B.step)\n        return range(start, end, step)\n    elif A.step == B.step:\n        a, b = min(A.start, B.start), max(A.start, B.start)\n        if (b - a) % A.step != 0:  # then the ranges are offset.\n            return range(0)\n        else:\n            return range(b, end, step)\n    else:\n        # determine common step size:\n        step = max(A.step, B.step) if math.gcd(A.step, B.step) != 1 else A.step * B.step\n        # examples:\n        # 119 &lt;-- 17 if 1 != 1 else 119 &lt;-- max(7, 17) if math.gcd(7, 17) != 1 else 7 * 17\n        #  30 &lt;-- 30 if 3 != 1 else 90 &lt;-- max(3, 30) if math.gcd(3, 30) != 1 else 3*30\n        if A.step &lt; B.step:\n            for n in range(a_start, end, A.step):  # increment in smallest step to identify the first common value.\n                if n &lt; b_start:\n                    continue\n                elif (n - b_start) % B.step == 0:\n                    return range(n, end, step)  # common value found.\n        else:\n            for n in range(b_start, end, B.step):\n                if n &lt; a_start:\n                    continue\n                elif (n - a_start) % A.step == 0:\n                    return range(n, end, step)\n\n        return range(0)\n</code></pre>"},{"location":"reference/utils/#tablite.utils.summary_statistics","title":"<code>tablite.utils.summary_statistics(values, counts)</code>","text":"<p>values: any type counts: integer</p> <p>returns dict with: - min (int/float, length of str, date) - max (int/float, length of str, date) - mean (int/float, length of str, date) - median (int/float, length of str, date) - stdev (int/float, length of str, date) - mode (int/float, length of str, date) - distinct (number of distinct values) - iqr (int/float, length of str, date) - sum (int/float, length of str, date) - histogram (2 arrays: values, count of each values)</p> Source code in <code>tablite/utils.py</code> <pre><code>def summary_statistics(values, counts):\n    \"\"\"\n    values: any type\n    counts: integer\n\n    returns dict with:\n    - min (int/float, length of str, date)\n    - max (int/float, length of str, date)\n    - mean (int/float, length of str, date)\n    - median (int/float, length of str, date)\n    - stdev (int/float, length of str, date)\n    - mode (int/float, length of str, date)\n    - distinct (number of distinct values)\n    - iqr (int/float, length of str, date)\n    - sum (int/float, length of str, date)\n    - histogram (2 arrays: values, count of each values)\n    \"\"\"\n    # determine the dominant datatype:\n    dtypes = defaultdict(int)\n    most_frequent, most_frequent_dtype = 0, int\n    for v, c in zip(values, counts):\n        dtype = type(v)\n        total = dtypes[dtype] + c\n        dtypes[dtype] = total\n        if total &gt; most_frequent:\n            most_frequent_dtype = dtype\n            most_frequent = total\n\n    if most_frequent == 0:\n        return {}\n\n    most_frequent_dtype = max(dtypes, key=dtypes.get)\n    mask = [type(v) == most_frequent_dtype for v in values]\n    v = list(compress(values, mask))\n    c = list(compress(counts, mask))\n\n    f = summary_methods.get(most_frequent_dtype, int)\n    result = f(v, c)\n    result[\"distinct\"] = len(values)\n    result[\"summary type\"] = most_frequent_dtype.__name__\n    result[\"histogram\"] = [values, counts]\n    assert set(result.keys()) == required_keys, \"Key missing!\"\n    return result\n</code></pre>"},{"location":"reference/utils/#tablite.utils.date_range","title":"<code>tablite.utils.date_range(start, stop, step)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def date_range(start, stop, step):\n    if not isinstance(start, datetime):\n        raise TypeError(\"start is not datetime\")\n    if not isinstance(stop, datetime):\n        raise TypeError(\"stop is not datetime\")\n    if not isinstance(step, timedelta):\n        raise TypeError(\"step is not timedelta\")\n    n = (stop - start) // step\n    return [start + step * i for i in range(n)]\n</code></pre>"},{"location":"reference/utils/#tablite.utils.dict_to_rows","title":"<code>tablite.utils.dict_to_rows(d)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def dict_to_rows(d):\n    type_check(d, dict)\n    rows = []\n    max_length = max(len(i) for i in d.values())\n    order = list(d.keys())\n    rows.append(order)\n    for i in range(max_length):\n        row = [d[k][i] for k in order]\n        rows.append(row)\n    return rows\n</code></pre>"},{"location":"reference/utils/#tablite.utils.calc_col_count","title":"<code>tablite.utils.calc_col_count(letters: str)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def calc_col_count(letters: str):\n    ord_nil = ord(\"A\") - 1\n    cols_per_letter = ord(\"Z\") - ord_nil\n    col_count = 0\n\n    for i, v in enumerate(reversed(letters)):\n        col_count = col_count + (ord(v) - ord_nil) * pow(cols_per_letter, i)\n\n    return col_count\n</code></pre>"},{"location":"reference/utils/#tablite.utils.calc_true_dims","title":"<code>tablite.utils.calc_true_dims(sheet)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def calc_true_dims(sheet):\n    src = sheet._get_source()\n    max_col, max_row = 0, 0\n\n    regex = re.compile(\"\\d+\")\n\n    def handleStartElement(name, attrs):\n        nonlocal max_col, max_row\n\n        if name == \"c\":\n            last_index = attrs[\"r\"]\n            idx, _ = next(regex.finditer(last_index)).span()\n            letters, digits = last_index[0:idx], int(last_index[idx:])\n\n            col_idx, row_idx = calc_col_count(letters), digits\n\n            max_col, max_row = max(max_col, col_idx), max(max_row, row_idx)\n\n    parser = expat.ParserCreate()\n    parser.buffer_text = True\n    parser.StartElementHandler = handleStartElement\n    parser.ParseFile(src)\n\n    return max_col, max_row\n</code></pre>"},{"location":"reference/utils/#tablite.utils.fixup_worksheet","title":"<code>tablite.utils.fixup_worksheet(worksheet)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def fixup_worksheet(worksheet):\n    try:\n        ws_cols, ws_rows = calc_true_dims(worksheet)\n\n        worksheet._max_column = ws_cols\n        worksheet._max_row = ws_rows\n    except Exception as e:\n        logging.error(f\"Failed to fetch true dimensions: {e}\")\n</code></pre>"},{"location":"reference/utils/#tablite.utils.update_access_time","title":"<code>tablite.utils.update_access_time(path)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def update_access_time(path):\n    path = Path(path)\n    stat = path.stat()\n    os.utime(path, (now(), stat.st_mtime))\n</code></pre>"},{"location":"reference/utils/#tablite.utils.load_numpy","title":"<code>tablite.utils.load_numpy(path)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def load_numpy(path):\n    update_access_time(path)\n\n    return np.load(path, allow_pickle=True, fix_imports=False)\n</code></pre>"},{"location":"reference/utils/#tablite.utils.select_type_name","title":"<code>tablite.utils.select_type_name(dtypes: dict)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def select_type_name(dtypes: dict):\n    dtypes = [t for t in dtypes.items() if t[0] != NoneType]\n\n    if len(dtypes) == 0:\n        return \"empty\"\n\n    (best_type, _), *_ = sorted(dtypes, key=lambda t: t[1], reverse=True)\n\n    return best_type.__name__\n</code></pre>"},{"location":"reference/utils/#tablite.utils.get_predominant_types","title":"<code>tablite.utils.get_predominant_types(table, all_dtypes=None)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def get_predominant_types(table, all_dtypes=None):\n    if all_dtypes is None:\n        all_dtypes = table.types()\n\n    dtypes = {\n        k: select_type_name(v)\n        for k, v in all_dtypes.items()\n    }\n\n    return dtypes\n</code></pre>"},{"location":"reference/utils/#tablite.utils.py_to_nim_encoding","title":"<code>tablite.utils.py_to_nim_encoding(encoding: str) -&gt; str</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def py_to_nim_encoding(encoding: str) -&gt; str:\n    if encoding is None or encoding.lower() in [\"ascii\", \"utf8\", \"utf-8\", \"utf-8-sig\"]:\n        return \"ENC_UTF8\"\n    elif encoding.lower() in [\"utf16\", \"utf-16\"]:\n        return \"ENC_UTF16\"\n    elif encoding in Config.NIM_SUPPORTED_CONV_TYPES:\n        return f\"ENC_CONV|{encoding}\"\n\n    raise NotImplementedError(f\"encoding not implemented: {encoding}\")\n</code></pre>"},{"location":"reference/version/","title":"Version","text":""},{"location":"reference/version/#tablite.version","title":"<code>tablite.version</code>","text":""},{"location":"reference/version/#tablite.version-attributes","title":"Attributes","text":""},{"location":"reference/version/#tablite.version.__version_info__","title":"<code>tablite.version.__version_info__ = (major, minor, patch)</code>  <code>module-attribute</code>","text":""},{"location":"reference/version/#tablite.version.__version__","title":"<code>tablite.version.__version__ = '.'.join(str(i) for i in __version_info__)</code>  <code>module-attribute</code>","text":""}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Tablite","text":""},{"location":"#contents","title":"Contents","text":"<ul> <li>introduction</li> <li>installation</li> <li>feature overview</li> <li>api</li> <li>tutorial</li> <li>latest updates</li> <li>credits</li> </ul>"},{"location":"#introduction","title":"Introduction","text":"<p><code>Tablite</code> seeks to be the go-to library for manipulating tabular data with an api that is as close in syntax to pure python as possible. </p>"},{"location":"#even-smaller-memory-footprint","title":"Even smaller memory footprint","text":"<p>Tablite uses numpys fileformat as a backend with strong abstraction, so that copy, append &amp; repetition of data is handled in pages. This is imperative for incremental data processing.</p> <p>Tablite tests for memory footprint. One test compares the memory footprint of 10,000,000 integers where <code>tablite</code> will use &lt; 1 Mb RAM in contrast to python which will require around 133.7 Mb of RAM (1M lists with 10 integers). Tablite also tests to assure that working with 1Tb of data is tolerable.</p> <p>Tablite achieves this minimal memory footprint by using a temporary storage set in <code>config.Config.workdir</code> as <code>tempfile.gettempdir()/tablite-tmp</code>. If your OS (windows/linux/mac) sits on a SSD this will benefit from high IOPS and permit slices of 9,000,000,000 rows in less than a second.</p>"},{"location":"#multiprocessing-enabled-by-default","title":"Multiprocessing enabled by default","text":"<p>Tablite uses numpy whereever possible and applies multiprocessing for bypassing the GIL on all major operations.  CSV import is performed in C through using <code>nim</code>s compiler and is as fast the hardware allows.</p>"},{"location":"#all-algorithms-have-been-reworked-to-respect-memory-limits","title":"All algorithms have been reworked to respect memory limits","text":"<p>Tablite respects the limits of free memory by tagging the free memory and defining task size before each memory intensive task is initiated (join, groupby, data import, etc). If you still run out of memory you may try to reduce the <code>config.Config.PAGE_SIZE</code> and rerun your program.</p>"},{"location":"#100-support-for-all-python-datatypes","title":"100% support for all python datatypes","text":"<p>Tablite wants to make it easy for you to work with data. <code>tablite.Table's</code> behave like a dict with lists:</p> <p><code>my_table[column name] = [... data ...]</code>.</p> <p>Tablite uses datatype mapping to native numpy types where possible and uses type mapping for non-native types such as timedelta, None, date, time\u2026 e.g. what you put in, is what you get out. This is inspired by bank python.</p>"},{"location":"#light-weight","title":"Light weight","text":"<p>Tablite is ~200 kB.</p>"},{"location":"#helpful","title":"Helpful","text":"<p>Tablite wants you to be productive, so a number of helpers are available. </p> <ul> <li><code>Table.import_file</code> to import csv*, tsv, txt, xls, xlsx, xlsm, ods, zip and logs. There is automatic type detection (see tutorial.ipynb )</li> <li>To peek into any supported file use <code>get_headers</code> which shows the first 10 rows.</li> <li>Use <code>mytable.rows</code> and <code>mytable.columns</code> to iterate over rows or columns.</li> <li>Create multi-key <code>.index</code> for quick lookups.</li> <li>Perform multi-key <code>.sort</code>,</li> <li>Filter using <code>.any</code> and <code>.all</code> to select specific rows.</li> <li>use multi-key <code>.lookup</code> and <code>.join</code> to find data across tables.</li> <li>Perform <code>.groupby</code> and reorganise data as a <code>.pivot</code> table with max, min, sum, first, last, count, unique, average, st.deviation, median and mode</li> <li>Append / concatenate tables with <code>+=</code> which automatically sorts out the columns - even if they're not in perfect order.</li> <li>Should you tables be similar but not the identical you can use <code>.stack</code> to \"stack\" tables on top of each other</li> </ul> <p>If you're still missing something add it to the wishlist</p>"},{"location":"#installation","title":"Installation","text":"<p>Get it from pypi: </p> <p>Install: <code>pip install tablite</code> Usage:  <code>&gt;&gt;&gt; from tablite import Table</code> </p>"},{"location":"#build-test","title":"Build &amp; test","text":"<p>install nim &gt;= 2.0.0</p> <p>run: <code>chmod +x ./build_nim.sh</code> run: <code>./build_nim.sh</code></p> <p>Should the default nim not be your desired taste, please use <code>nims</code> environment manager (<code>atlas</code>) and run <code>source nim-2.0.0/activate.sh</code> on UNIX or <code>nim-2.0.0/activate.bat</code> on windows.</p> <pre><code>install python &gt;= 3.8\npython -m venv /your/venv/dir\nactivate /your/venv/dir\npip install -r requirements.txt\npip install -r requirements_for_testing.py\npytest ./tests\n</code></pre>"},{"location":"#feature-overview","title":"Feature overview","text":"want to... this way... loop over rows <code>[ row for row in table.rows ]</code> loop over columns <code>[ table[col_name] for col_name in table.columns ]</code> slice <code>myslice = table['A', 'B', slice(0,None,15)]</code> get column by name <code>my_table['A']</code> get row by index <code>my_table[9_000_000_001]</code> value update <code>mytable['A'][2] = new value</code> update w. list comprehension <code>mytable['A'] = [ x*x for x in mytable['A'] if x % 2 != 0 ]</code> join <code>a_join = numbers.join(letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter'], kind='left')</code> lookup <code>travel_plan = friends.lookup(bustable, (DataTypes.time(21, 10), \"&lt;=\", 'time'), ('stop', \"==\", 'stop'))</code> groupby <code>group_by = table.groupby(keys=['C', 'B'], functions=[('A', gb.count)])</code> pivot table <code>my_pivot = t.pivot(rows=['C'], columns=['A'], functions=[('B', gb.sum), ('B', gb.count)], values_as_rows=False)</code> index <code>indices = old_table.index(*old_table.columns)</code> sort <code>lookup1_sorted = lookup_1.sort(**{'time': True, 'name':False, \"sort_mode\":'unix'})</code> filter <code>true, false = unfiltered.filter( [{\"column1\": 'a', \"criteria\":\"&gt;=\", 'value2':3}, ... more criteria ... ], filter_type='all' )</code> find any <code>any_even_rows = mytable.any('A': lambda x : x%2==0, 'B': lambda x &gt; 0)</code> find all <code>all_even_rows = mytable.all('A': lambda x : x%2==0, 'B': lambda x &gt; 0)</code> to json <code>json_str = my_table.to_json()</code> from json <code>Table.from_json(json_str)</code>"},{"location":"#api","title":"API","text":"<p>To view the detailed API see api</p>"},{"location":"#tutorial","title":"Tutorial","text":"<p>To learn more see the tutorial.ipynb (Jupyter notebook)</p>"},{"location":"#latest-updates","title":"Latest updates","text":"<p>See changelog.md</p>"},{"location":"#credits","title":"Credits","text":"<ul> <li>Eugene Antonov - the api documentation.</li> <li>Audrius Kulikajevas - Edge case testing / various bugs, Jupyter notebook integration.</li> <li>Ovidijus Grigas - various bugs, documentation.</li> <li>Martynas Kaunas - GroupBy functionality.</li> <li>Sergej Sinkarenko - various bugs.</li> <li>Lori Cooper - spell checking.</li> </ul>"},{"location":"benchmarks/","title":"Benchmarks","text":"In\u00a0[2]: Copied! <pre>import psutil, os, gc, shutil, tempfile\nfrom pathlib import Path\nfrom time import perf_counter, time\nfrom tablite import Table\nfrom tablite.datasets import synthetic_order_data\nfrom tablite.config import Config\n\nConfig.TQDM_DISABLE = True\n</pre> import psutil, os, gc, shutil, tempfile from pathlib import Path from time import perf_counter, time from tablite import Table from tablite.datasets import synthetic_order_data from tablite.config import Config  Config.TQDM_DISABLE = True In\u00a0[3]: Copied! <pre>process = psutil.Process(os.getpid())\n\ndef make_tables(sizes=[1,2,5,10,20,50]):\n    # The last tables are too big for RAM (~24Gb), so I create subtables of 1M rows and append them.\n    t = synthetic_order_data(Config.PAGE_SIZE)\n    real, flat = t.nbytes()\n    print(f\"Table {len(t):,} rows is {real/1e6:,.0f} Mb on disk\")\n\n    tables = [t]  # 1M rows.\n\n    last = 1\n    t2 = t.copy()\n    for i in sizes[1:]:\n        t2 = t2.copy()\n        for _ in range(i-last):\n            t2 += synthetic_order_data(Config.PAGE_SIZE)  # these are all unique\n        last = i\n        real, flat = t2.nbytes()\n        tables.append(t2)\n        print(f\"Table {len(t2):,} rows is {real/1e6:,.0f} Mb on disk\")\n    return tables\n\ntables = make_tables()\n</pre> process = psutil.Process(os.getpid())  def make_tables(sizes=[1,2,5,10,20,50]):     # The last tables are too big for RAM (~24Gb), so I create subtables of 1M rows and append them.     t = synthetic_order_data(Config.PAGE_SIZE)     real, flat = t.nbytes()     print(f\"Table {len(t):,} rows is {real/1e6:,.0f} Mb on disk\")      tables = [t]  # 1M rows.      last = 1     t2 = t.copy()     for i in sizes[1:]:         t2 = t2.copy()         for _ in range(i-last):             t2 += synthetic_order_data(Config.PAGE_SIZE)  # these are all unique         last = i         real, flat = t2.nbytes()         tables.append(t2)         print(f\"Table {len(t2):,} rows is {real/1e6:,.0f} Mb on disk\")     return tables  tables = make_tables() <pre>Table 1,000,000 rows is 256 Mb on disk\nTable 2,000,000 rows is 512 Mb on disk\nTable 5,000,000 rows is 1,280 Mb on disk\nTable 10,000,000 rows is 2,560 Mb on disk\nTable 20,000,000 rows is 5,120 Mb on disk\nTable 50,000,000 rows is 12,800 Mb on disk\n</pre> <p>The values in the tables above are all unique!</p> In\u00a0[4]: Copied! <pre>tables[-1]\n</pre> tables[-1] Out[4]: ~#1234567891011         0114014953182952021-10-06T00:00:0050814119375C3-4HGQ21\u00b0XYZ1.244647268201734421.367107051830455         129320231372182021-08-26T00:00:005007718568C5-5FZU0\u00b00.55294485347516132.6980406874392537         2312569602250812021-12-21T00:00:0050197029074C2-3GTK6\u00b0XYZ1.99739754559065617.513164305723787         3414012777817432021-08-23T00:00:0050818024969C4-3BYP6\u00b0XYZ0.047497125538289577.388171617130485         459426667674262021-07-31T00:00:0050307113074C5-2CCC21\u00b0ABC1.0219215027612885.21324123446987         5612186131851272021-12-01T00:00:0050484117249C5-4WGT21\u00b00.2038764258434556712.190974436133764         676070424343982021-11-29T00:00:0050578011564C2-3LUL0\u00b0XYZ2.2367835158480444.340628097363572.......................................49,999,9939999946602693775472021-09-17T00:00:005015409706C4-3AHQ21\u00b0XYZ0.083216645843125856.56780297752790549,999,9949999955709798646952021-08-01T00:00:0050149125006C1-2FWH6\u00b01.04763923662266419.50710544462706549,999,9959999963551956078252021-07-29T00:00:0050007026992C4-3GVG21\u00b02.20440816560941411.2706443974284949,999,99699999720762240577282021-10-16T00:00:0050950113339C5-4NKS0\u00b02.1593110498135494.21575620046596149,999,9979999986577247891352021-12-21T00:00:0050069114747C2-4LYGNone1.64809640191698683.094420483625827349,999,9989999999775312438842021-12-02T00:00:0050644129345C2-5DRH6\u00b02.30911421692753110.82706867207146849,999,999100000012290713920652021-08-23T00:00:0050706119732C4-5AGB6\u00b00.488871405593691630.8580085696389939 In\u00a0[5]: Copied! <pre>def save_load_benchmarks(tables):\n    tmp = Path(tempfile.gettempdir()) / \"junk\"\n    tmp.mkdir(exist_ok=True)\n\n    results = Table()\n    results.add_columns('rows', 'save (sec)', 'load (sec)')\n    for t in tables:\n        fn = tmp / f'{len(t)}.tpz'\n        start = perf_counter()\n        t.save(fn)\n        end = perf_counter()\n        save = round(end-start,3)\n        assert fn.exists()\n        \n        \n        start = perf_counter()\n        t2 = Table.load(fn)\n        end = perf_counter()\n        load = round(end-start,3)\n        print(f\"saving {len(t):,} rows ({fn.stat().st_size/1e6:,.0f} Mb) took {save:,.3f} seconds. loading took {load:,.3f} seconds\")\n        del t2\n        fn.unlink()\n        results.add_rows(len(t), save, load)\n    \n    r = results\n    r['save r/sec'] = [int(a/b) if b!=0  else \"nil\" for a,b in zip(r['rows'], r['save (sec)']) ]\n    r['load r/sec'] = [int(a/b) if b!=0  else \"nil\" for a,b in zip(r['rows'], r['load (sec)'])]\n\n    return results\n</pre> def save_load_benchmarks(tables):     tmp = Path(tempfile.gettempdir()) / \"junk\"     tmp.mkdir(exist_ok=True)      results = Table()     results.add_columns('rows', 'save (sec)', 'load (sec)')     for t in tables:         fn = tmp / f'{len(t)}.tpz'         start = perf_counter()         t.save(fn)         end = perf_counter()         save = round(end-start,3)         assert fn.exists()                           start = perf_counter()         t2 = Table.load(fn)         end = perf_counter()         load = round(end-start,3)         print(f\"saving {len(t):,} rows ({fn.stat().st_size/1e6:,.0f} Mb) took {save:,.3f} seconds. loading took {load:,.3f} seconds\")         del t2         fn.unlink()         results.add_rows(len(t), save, load)          r = results     r['save r/sec'] = [int(a/b) if b!=0  else \"nil\" for a,b in zip(r['rows'], r['save (sec)']) ]     r['load r/sec'] = [int(a/b) if b!=0  else \"nil\" for a,b in zip(r['rows'], r['load (sec)'])]      return results  In\u00a0[6]: Copied! <pre>slb = save_load_benchmarks(tables)\n</pre> slb = save_load_benchmarks(tables) <pre>saving 1,000,000 rows (49 Mb) took 2.148 seconds. loading took 0.922 seconds\nsaving 2,000,000 rows (98 Mb) took 4.267 seconds. loading took 1.820 seconds\nsaving 5,000,000 rows (246 Mb) took 10.618 seconds. loading took 4.482 seconds\nsaving 10,000,000 rows (492 Mb) took 21.291 seconds. loading took 8.944 seconds\nsaving 20,000,000 rows (984 Mb) took 42.603 seconds. loading took 17.821 seconds\nsaving 50,000,000 rows (2,461 Mb) took 106.644 seconds. loading took 44.600 seconds\n</pre> In\u00a0[7]: Copied! <pre>slb\n</pre> slb Out[7]: #rowssave (sec)load (sec)save r/secload r/sec 010000002.1480.9224655491084598 120000004.2671.824687131098901 2500000010.6184.4824708981115573 31000000021.2918.9444696821118067 42000000042.60317.8214694501122271 550000000106.64444.64688491121076 <p>With various compression options</p> In\u00a0[8]: Copied! <pre>def save_compression_benchmarks(t):\n    tmp = Path(tempfile.gettempdir()) / \"junk\"\n    tmp.mkdir(exist_ok=True)\n\n    import zipfile  # https://docs.python.org/3/library/zipfile.html#zipfile.ZipFile\n    methods = [(None, zipfile.ZIP_STORED, \"zip stored\"), (None, zipfile.ZIP_LZMA, \"zip lzma\")]\n    methods += [(i, zipfile.ZIP_DEFLATED, \"zip deflated\") for i in range(0,10)]\n    methods += [(i, zipfile.ZIP_BZIP2, \"zip bzip2\") for i in range(1,10)]\n\n    results = Table()\n    results.add_columns('file size (Mb)', 'method', 'write (sec)', 'read (sec)')\n    for level, method, name in methods:\n        fn = tmp / f'{len(t)}.tpz'\n        start = perf_counter()  \n        t.save(fn, compression_method=method, compression_level=level)\n        end = perf_counter()\n        write = round(end-start,3)\n        assert fn.exists()\n        size = int(fn.stat().st_size/1e6)\n        # print(f\"{name}(level={level}): {len(t):,} rows ({size} Mb) took {write:,.3f} secconds to save\", end='')\n        \n        start = perf_counter()\n        t2 = Table.load(fn)\n        end = perf_counter()\n        read = round(end-start,3)\n        # print(f\" and {end-start:,.3} seconds to load\")\n        print(\".\", end='')\n        \n        del t2\n        fn.unlink()\n        results.add_rows(size, f\"{name}(level={level})\", write, read)\n        \n    \n    r = results\n    r.sort({'write (sec)':True})\n    r['write (rps)'] = [int(1_000_000/b) for b in r['write (sec)']]\n    r['read (rps)'] = [int(1_000_000/b) for b in r['read (sec)']]\n    return results\n</pre> def save_compression_benchmarks(t):     tmp = Path(tempfile.gettempdir()) / \"junk\"     tmp.mkdir(exist_ok=True)      import zipfile  # https://docs.python.org/3/library/zipfile.html#zipfile.ZipFile     methods = [(None, zipfile.ZIP_STORED, \"zip stored\"), (None, zipfile.ZIP_LZMA, \"zip lzma\")]     methods += [(i, zipfile.ZIP_DEFLATED, \"zip deflated\") for i in range(0,10)]     methods += [(i, zipfile.ZIP_BZIP2, \"zip bzip2\") for i in range(1,10)]      results = Table()     results.add_columns('file size (Mb)', 'method', 'write (sec)', 'read (sec)')     for level, method, name in methods:         fn = tmp / f'{len(t)}.tpz'         start = perf_counter()           t.save(fn, compression_method=method, compression_level=level)         end = perf_counter()         write = round(end-start,3)         assert fn.exists()         size = int(fn.stat().st_size/1e6)         # print(f\"{name}(level={level}): {len(t):,} rows ({size} Mb) took {write:,.3f} secconds to save\", end='')                  start = perf_counter()         t2 = Table.load(fn)         end = perf_counter()         read = round(end-start,3)         # print(f\" and {end-start:,.3} seconds to load\")         print(\".\", end='')                  del t2         fn.unlink()         results.add_rows(size, f\"{name}(level={level})\", write, read)                   r = results     r.sort({'write (sec)':True})     r['write (rps)'] = [int(1_000_000/b) for b in r['write (sec)']]     r['read (rps)'] = [int(1_000_000/b) for b in r['read (sec)']]     return results In\u00a0[9]: Copied! <pre>scb = save_compression_benchmarks(tables[0])\n</pre> scb = save_compression_benchmarks(tables[0]) <pre>.....................</pre> <pre>creating sort index:   0%|          | 0/1 [00:00&lt;?, ?it/s]\rcreating sort index: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 1/1 [00:00&lt;00:00, 268.92it/s]\n</pre> In\u00a0[10]: Copied! <pre>scb[0:20]\n</pre> scb[0:20] Out[10]: #file size (Mb)methodwrite (sec)read (sec)write (rps)read (rps) 0256zip stored(level=None)0.3960.47525252522105263 129zip lzma(level=None)95.1372.22810511448833 2256zip deflated(level=0)0.5350.59518691581680672 349zip deflated(level=1)2.150.9224651161084598 447zip deflated(level=2)2.2640.9124416961096491 543zip deflated(level=3)3.0490.833279761204819 644zip deflated(level=4)2.920.8623424651160092 742zip deflated(level=5)4.0340.8692478921150747 840zip deflated(level=6)8.5580.81168491250000 939zip deflated(level=7)13.6950.7787301912853471038zip deflated(level=8)56.9720.7921755212626261138zip deflated(level=9)122.6230.791815512642221229zip bzip2(level=1)15.1214.065661332460021329zip bzip2(level=2)16.0474.214623162373041429zip bzip2(level=3)16.8584.409593192268081529zip bzip2(level=4)17.6485.141566631945141629zip bzip2(level=5)18.6746.009535501664171729zip bzip2(level=6)19.4056.628515331508751829zip bzip2(level=7)19.9546.714501151489421929zip bzip2(level=8)20.5956.96148555143657 <p>Conclusions</p> <ul> <li>Fastest: zip stored with no compression takes handles</li> </ul> In\u00a0[11]: Copied! <pre>def to_sql_benchmark(t, rows=1_000_000):\n    t2 = t[:rows]\n    write_start = time()\n    _ = t2.to_sql(name='1')\n    write_end = time()\n    write = round(write_end-write_start,3)\n    return ( t.to_sql.__name__, write, 0, len(t2), \"\" , \"\" )\n</pre> def to_sql_benchmark(t, rows=1_000_000):     t2 = t[:rows]     write_start = time()     _ = t2.to_sql(name='1')     write_end = time()     write = round(write_end-write_start,3)     return ( t.to_sql.__name__, write, 0, len(t2), \"\" , \"\" )  In\u00a0[12]: Copied! <pre>def to_json_benchmark(t, rows=1_000_000):\n    t2 = t[:rows]\n\n    tmp = Path(tempfile.gettempdir()) / \"junk\"\n    tmp.mkdir(exist_ok=True)\n    path = tmp / \"1.json\" \n    \n    write_start = time()\n    bytestr = t2.to_json()\n    with path.open('w') as fo:\n        fo.write(bytestr)\n    write_end = time()\n    write = round(write_end-write_start,3)\n\n    read_start = time()\n    with path.open('r') as fi:\n        _ = Table.from_json(fi.read())  # &lt;-- JSON\n    read_end = time()\n    read = round(read_end-read_start,3)\n\n    return ( t.to_json.__name__, write, read, len(t2), int(path.stat().st_size/1e6), \"\" )\n</pre> def to_json_benchmark(t, rows=1_000_000):     t2 = t[:rows]      tmp = Path(tempfile.gettempdir()) / \"junk\"     tmp.mkdir(exist_ok=True)     path = tmp / \"1.json\"           write_start = time()     bytestr = t2.to_json()     with path.open('w') as fo:         fo.write(bytestr)     write_end = time()     write = round(write_end-write_start,3)      read_start = time()     with path.open('r') as fi:         _ = Table.from_json(fi.read())  # &lt;-- JSON     read_end = time()     read = round(read_end-read_start,3)      return ( t.to_json.__name__, write, read, len(t2), int(path.stat().st_size/1e6), \"\" )  In\u00a0[13]: Copied! <pre>def f(t, args):\n    rows, c1, c1_kw, c2, c2_kw = args\n    t2 = t[:rows]\n\n    call = getattr(t2, c1)\n    assert callable(call)\n\n    write_start = time()\n    call(**c1_kw)\n    write_end = time()\n    write = round(write_end-write_start,3)\n\n    for _ in range(10):\n        gc.collect()\n\n    read_start = time()\n    if callable(c2):\n        c2(**c2_kw)\n    read_end = time()\n    read = round(read_end-read_start,3)\n\n    fn = c2_kw['path']\n    assert fn.exists()\n    fs = int(fn.stat().st_size/1e6)\n    config = {k:v for k,v in c2_kw.items() if k!= 'path'}\n\n    return ( c1, write, read, len(t2), fs , str(config))\n</pre> def f(t, args):     rows, c1, c1_kw, c2, c2_kw = args     t2 = t[:rows]      call = getattr(t2, c1)     assert callable(call)      write_start = time()     call(**c1_kw)     write_end = time()     write = round(write_end-write_start,3)      for _ in range(10):         gc.collect()      read_start = time()     if callable(c2):         c2(**c2_kw)     read_end = time()     read = round(read_end-read_start,3)      fn = c2_kw['path']     assert fn.exists()     fs = int(fn.stat().st_size/1e6)     config = {k:v for k,v in c2_kw.items() if k!= 'path'}      return ( c1, write, read, len(t2), fs , str(config))  In\u00a0[14]: Copied! <pre>def import_export_benchmarks(tables):\n    Config.PROCESSING_MODE = Config.FALSE\n        \n    t = sorted(tables, key=lambda x: len(x), reverse=True)[0]\n    \n    tmp = Path(tempfile.gettempdir()) / \"junk\"\n    tmp.mkdir(exist_ok=True)   \n\n    args = [\n        (   100_000, \"to_xlsx\", {'path': tmp/'1.xlsx'}, Table.from_file, {\"path\":tmp/'1.xlsx', \"sheet\":\"pyexcel_sheet1\"}),\n        (    50_000,  \"to_ods\",  {'path': tmp/'1.ods'}, Table.from_file, {\"path\":tmp/'1.ods', \"sheet\":\"pyexcel_sheet1\"} ),  # 50k rows, otherwise MemoryError.\n        ( 1_000_000,  \"to_csv\",  {'path': tmp/'1.csv'}, Table.from_file, {\"path\":tmp/'1.csv'}                           ),\n        ( 1_000_000,  \"to_csv\",  {'path': tmp/'1.csv'}, Table.from_file, {\"path\":tmp/'1.csv', \"guess_datatypes\":False}),\n        (10_000_000,  \"to_csv\",  {'path': tmp/'1.csv'}, Table.from_file, {\"path\":tmp/'1.csv', \"guess_datatypes\":False}),\n        ( 1_000_000,  \"to_tsv\",  {'path': tmp/'1.tsv'}, Table.from_file, {\"path\":tmp/'1.tsv'}                           ),\n        ( 1_000_000, \"to_text\",  {'path': tmp/'1.txt'}, Table.from_file, {\"path\":tmp/'1.txt'}                           ),\n        ( 1_000_000, \"to_html\", {'path': tmp/'1.html'}, Table.from_file, {\"path\":tmp/'1.html'}                          ),\n        ( 1_000_000, \"to_hdf5\", {'path': tmp/'1.hdf5'}, Table.from_file, {\"path\":tmp/'1.hdf5'}                          )\n    ]\n\n    results = Table()\n    results.add_columns('method', 'write (s)', 'read (s)', 'rows', 'size (Mb)', 'config')\n\n    results.add_rows( to_sql_benchmark(t) )\n    results.add_rows( to_json_benchmark(t) )\n\n    for arg in args:\n        if len(t)&lt;arg[0]:\n            continue\n        print(\".\", end='')\n        try:\n            results.add_rows( f(t, arg) )\n        except MemoryError:\n            results.add_rows( arg[1], \"Memory Error\", \"NIL\", args[0], \"NIL\", \"N/A\")\n    \n    r = results\n    r['read r/sec'] = [int(a/b) if b!=0  else \"nil\" for a,b in zip(r['rows'], r['read (s)']) ]\n    r['write r/sec'] = [int(a/b) if b!=0  else \"nil\" for a,b in zip(r['rows'], r['write (s)'])]\n\n    shutil.rmtree(tmp)\n    return results\n</pre> def import_export_benchmarks(tables):     Config.PROCESSING_MODE = Config.FALSE              t = sorted(tables, key=lambda x: len(x), reverse=True)[0]          tmp = Path(tempfile.gettempdir()) / \"junk\"     tmp.mkdir(exist_ok=True)         args = [         (   100_000, \"to_xlsx\", {'path': tmp/'1.xlsx'}, Table.from_file, {\"path\":tmp/'1.xlsx', \"sheet\":\"pyexcel_sheet1\"}),         (    50_000,  \"to_ods\",  {'path': tmp/'1.ods'}, Table.from_file, {\"path\":tmp/'1.ods', \"sheet\":\"pyexcel_sheet1\"} ),  # 50k rows, otherwise MemoryError.         ( 1_000_000,  \"to_csv\",  {'path': tmp/'1.csv'}, Table.from_file, {\"path\":tmp/'1.csv'}                           ),         ( 1_000_000,  \"to_csv\",  {'path': tmp/'1.csv'}, Table.from_file, {\"path\":tmp/'1.csv', \"guess_datatypes\":False}),         (10_000_000,  \"to_csv\",  {'path': tmp/'1.csv'}, Table.from_file, {\"path\":tmp/'1.csv', \"guess_datatypes\":False}),         ( 1_000_000,  \"to_tsv\",  {'path': tmp/'1.tsv'}, Table.from_file, {\"path\":tmp/'1.tsv'}                           ),         ( 1_000_000, \"to_text\",  {'path': tmp/'1.txt'}, Table.from_file, {\"path\":tmp/'1.txt'}                           ),         ( 1_000_000, \"to_html\", {'path': tmp/'1.html'}, Table.from_file, {\"path\":tmp/'1.html'}                          ),         ( 1_000_000, \"to_hdf5\", {'path': tmp/'1.hdf5'}, Table.from_file, {\"path\":tmp/'1.hdf5'}                          )     ]      results = Table()     results.add_columns('method', 'write (s)', 'read (s)', 'rows', 'size (Mb)', 'config')      results.add_rows( to_sql_benchmark(t) )     results.add_rows( to_json_benchmark(t) )      for arg in args:         if len(t) In\u00a0[15]: Copied! <pre>ieb = import_export_benchmarks(tables)\n</pre> ieb = import_export_benchmarks(tables) <pre>.........writing 12,000,000 records to /tmp/junk/1.hdf5... done\n</pre> In\u00a0[16]: Copied! <pre>ieb\n</pre> ieb Out[16]: #methodwrite (s)read (s)rowssize (Mb)configread r/secwrite r/sec 0to_sql12.34501000000nil81004 1to_json10.8144.406100000014222696392472 2to_xlsx10.56921.5721000009{'sheet': 'pyexcel_sheet1'}46359461 3to_ods29.17529.487500003{'sheet': 'pyexcel_sheet1'}16951713 4to_csv14.31515.7311000000108{}6356869856 5to_csv14.4388.1691000000108{'guess_datatypes': False}12241469261 6to_csv140.64599.45100000001080{'guess_datatypes': False}10055371100 7to_tsv13.83415.7631000000108{}6343972285 8to_text13.93715.6821000000108{}6376771751 9to_html12.5780.531000000228{}18867927950310to_hdf55.0112.3451000000316{}81004199600 <p>Conclusions</p> <p>Best:</p> <ul> <li>to/from JSON wins with 2.3M rps read</li> <li>to/from CSV/TSV/TEXT comes 2nd with config <code>guess_datatypes=False</code> with ~ 100k rps</li> </ul> <p>Worst:</p> <ul> <li>to/from ods burst the memory footprint and hence had to be reduced to 100k rows. It also had the slowest read rate with 1450 rps.</li> </ul> In\u00a0[17]: Copied! <pre>def contains_benchmark(table):\n    results = Table()\n    results.add_columns( \"column\", \"time (s)\" )\n    for name,col in table.columns.items():\n        n = len(col)\n        start,stop,step = int(n*0.02), int(n*0.98), int(n/100)\n        selection = col[start:stop:step]\n        total_time = 0.0\n        for v in selection:\n            start_time = perf_counter()\n            v in col  # &lt;--- test!\n            end_time = perf_counter()\n            total_time += (end_time - start_time)\n        avg_time = total_time / len(selection)\n        results.add_rows( name, round(avg_time,3) )\n\n    return results\n</pre> def contains_benchmark(table):     results = Table()     results.add_columns( \"column\", \"time (s)\" )     for name,col in table.columns.items():         n = len(col)         start,stop,step = int(n*0.02), int(n*0.98), int(n/100)         selection = col[start:stop:step]         total_time = 0.0         for v in selection:             start_time = perf_counter()             v in col  # &lt;--- test!             end_time = perf_counter()             total_time += (end_time - start_time)         avg_time = total_time / len(selection)         results.add_rows( name, round(avg_time,3) )      return results      In\u00a0[18]: Copied! <pre>has_it = contains_benchmark(tables[-1])\nhas_it\n</pre> has_it = contains_benchmark(tables[-1]) has_it Out[18]: #columntime (s) 0#0.001 110.043 220.032 330.001 440.001 550.001 660.006 770.003 880.006 990.00710100.04311110.655 In\u00a0[19]: Copied! <pre>def slicing_benchmark(table):\n    n = len(table)\n    start,stop,step = int(0.02*n), int(0.98*n), int(n / 20)  # from 2% to 98% in 20 large steps\n    start_time = perf_counter()\n    snip = table[start:stop:step]\n    end_time = perf_counter()\n    print(f\"reading {len(table):,} rows to find {len(snip):,} rows took {end_time-start_time:.3f} sec\")\n    return snip\n</pre> def slicing_benchmark(table):     n = len(table)     start,stop,step = int(0.02*n), int(0.98*n), int(n / 20)  # from 2% to 98% in 20 large steps     start_time = perf_counter()     snip = table[start:stop:step]     end_time = perf_counter()     print(f\"reading {len(table):,} rows to find {len(snip):,} rows took {end_time-start_time:.3f} sec\")     return snip In\u00a0[20]: Copied! <pre>slice_it = slicing_benchmark(tables[-1])\n</pre> slice_it = slicing_benchmark(tables[-1]) <pre>reading 50,000,000 rows to find 20 rows took 1.435 sec\n</pre> In\u00a0[22]: Copied! <pre>def column_selection_benchmark(tables):\n    results = Table()\n    results.add_columns( 'rows')\n    results.add_columns(*[f\"n cols={i}\" for i,_ in enumerate(tables[0].columns,start=1)])\n\n    for table in tables:\n        rr = [len(table)]\n        for ix, name in enumerate(table.columns):\n            cols = list(table.columns)[:ix+1]\n            start_time = perf_counter()\n            table[cols]\n            end_time = perf_counter()\n            rr.append(f\"{end_time-start_time:.5f}\")\n        results.add_rows( rr )\n    return results\n</pre> def column_selection_benchmark(tables):     results = Table()     results.add_columns( 'rows')     results.add_columns(*[f\"n cols={i}\" for i,_ in enumerate(tables[0].columns,start=1)])      for table in tables:         rr = [len(table)]         for ix, name in enumerate(table.columns):             cols = list(table.columns)[:ix+1]             start_time = perf_counter()             table[cols]             end_time = perf_counter()             rr.append(f\"{end_time-start_time:.5f}\")         results.add_rows( rr )     return results In\u00a0[23]: Copied! <pre>csb = column_selection_benchmark(tables)\nprint(\"times below are are in seconds\")\ncsb\n</pre> csb = column_selection_benchmark(tables) print(\"times below are are in seconds\") csb <pre>times below are are in seconds\n</pre> Out[23]: #rowsn cols=1n cols=2n cols=3n cols=4n cols=5n cols=6n cols=7n cols=8n cols=9n cols=10n cols=11n cols=12 010000000.000010.000060.000040.000040.000040.000040.000040.000040.000040.000040.000040.00004 120000000.000010.000080.000030.000030.000030.000030.000030.000030.000030.000030.000040.00004 250000000.000010.000050.000040.000040.000040.000040.000040.000040.000040.000040.000040.00004 3100000000.000020.000050.000040.000040.000040.000040.000070.000050.000050.000050.000050.00005 4200000000.000030.000060.000050.000050.000050.000050.000060.000060.000060.000060.000060.00006 5500000000.000090.000110.000100.000090.000090.000090.000090.000090.000090.000090.000100.00009 In\u00a0[33]: Copied! <pre>def iterrows_benchmark(table):\n    results = Table()\n    results.add_columns( 'n columns', 'time (s)')\n\n    columns = ['1']\n    for column in list(table.columns):\n        columns.append(column)\n        snip = table[columns, slice(500_000,1_500_000)]\n        start_time = perf_counter()\n        counts = 0\n        for row in snip.rows:\n            counts += 1\n        end_time = perf_counter()\n        results.add_rows( len(columns), round(end_time-start_time,3))\n\n    return results\n</pre> def iterrows_benchmark(table):     results = Table()     results.add_columns( 'n columns', 'time (s)')      columns = ['1']     for column in list(table.columns):         columns.append(column)         snip = table[columns, slice(500_000,1_500_000)]         start_time = perf_counter()         counts = 0         for row in snip.rows:             counts += 1         end_time = perf_counter()         results.add_rows( len(columns), round(end_time-start_time,3))      return results  In\u00a0[34]: Copied! <pre>iterb = iterrows_benchmark(tables[-1])\niterb\n</pre> iterb = iterrows_benchmark(tables[-1]) iterb Out[34]: #n columnstime (s) 029.951 139.816 249.859 359.93 469.985 579.942 689.958 799.867 8109.96 9119.93210129.8311139.861 In\u00a0[35]: Copied! <pre>import matplotlib.pyplot as plt\nplt.plot(iterb['n columns'], iterb['time (s)'])\nplt.show()\n</pre> import matplotlib.pyplot as plt plt.plot(iterb['n columns'], iterb['time (s)']) plt.show()  In\u00a0[28]: Copied! <pre>tables[-1].types()\n</pre> tables[-1].types() Out[28]: <pre>{'#': {int: 50000000},\n '1': {int: 50000000},\n '2': {str: 50000000},\n '3': {int: 50000000},\n '4': {int: 50000000},\n '5': {int: 50000000},\n '6': {str: 50000000},\n '7': {str: 50000000},\n '8': {str: 50000000},\n '9': {str: 50000000},\n '10': {float: 50000000},\n '11': {str: 50000000}}</pre> In\u00a0[29]: Copied! <pre>def dtypes_benchmark(tables):\n    dtypes_results = Table()\n    dtypes_results.add_columns(\"rows\", \"time (s)\")\n\n    for table in tables:\n        start_time = perf_counter()\n        dt = table.types()\n        end_time = perf_counter()\n        assert isinstance(dt, dict) and len(dt) != 0\n        dtypes_results.add_rows( len(table), round(end_time-start_time, 3) )\n\n    return dtypes_results\n</pre> def dtypes_benchmark(tables):     dtypes_results = Table()     dtypes_results.add_columns(\"rows\", \"time (s)\")      for table in tables:         start_time = perf_counter()         dt = table.types()         end_time = perf_counter()         assert isinstance(dt, dict) and len(dt) != 0         dtypes_results.add_rows( len(table), round(end_time-start_time, 3) )      return dtypes_results In\u00a0[30]: Copied! <pre>dtype_b = dtypes_benchmark(tables)\ndtype_b\n</pre> dtype_b = dtypes_benchmark(tables) dtype_b Out[30]: #rowstime (s) 010000000.0 120000000.0 250000000.0 3100000000.0 4200000000.0 5500000000.001 In\u00a0[31]: Copied! <pre>def any_benchmark(tables):\n    results = Table()\n    results.add_columns(\"rows\", *list(tables[0].columns))\n\n    for table in tables:\n        tmp = [len(table)]\n        for column in list(table.columns):\n            v = table[column][0]\n            start_time = perf_counter()\n            _ = table.any(**{column: v})\n            end_time = perf_counter()           \n            tmp.append(round(end_time-start_time,3))\n\n        results.add_rows( tmp )\n    return results\n</pre> def any_benchmark(tables):     results = Table()     results.add_columns(\"rows\", *list(tables[0].columns))      for table in tables:         tmp = [len(table)]         for column in list(table.columns):             v = table[column][0]             start_time = perf_counter()             _ = table.any(**{column: v})             end_time = perf_counter()                        tmp.append(round(end_time-start_time,3))          results.add_rows( tmp )     return results  In\u00a0[32]: Copied! <pre>anyb = any_benchmark(tables)\nanyb\n</pre>  anyb = any_benchmark(tables) anyb Out[32]: ~rows#1234567891011 010000000.1330.1330.1780.1330.2920.1470.1690.1430.2270.2590.1460.17 120000000.2680.2630.3430.2650.5670.2940.3350.2750.4640.5230.2890.323 250000000.6690.6530.9140.6691.4360.7230.8380.6941.1741.3350.6780.818 3100000001.3141.351.7451.3362.9021.491.6831.4142.3542.6181.3431.536 4200000002.5562.5343.3372.6025.6452.8273.2252.6464.5145.082.6933.083 5500000006.5716.4238.4556.69914.4847.9897.7986.25910.98912.486.7327.767 In\u00a0[36]: Copied! <pre>def all_benchmark(tables):\n    results = Table()\n    results.add_columns(\"rows\", *list(tables[0].columns))\n\n    for table in tables:\n        tmp = [len(table)]\n        for column in list(table.columns):\n            v = table[column][0]\n            start_time = perf_counter()\n            _ = table.all(**{column: v})\n            end_time = perf_counter()           \n            tmp.append(round(end_time-start_time,3))\n\n        results.add_rows( tmp )\n    return results\n</pre> def all_benchmark(tables):     results = Table()     results.add_columns(\"rows\", *list(tables[0].columns))      for table in tables:         tmp = [len(table)]         for column in list(table.columns):             v = table[column][0]             start_time = perf_counter()             _ = table.all(**{column: v})             end_time = perf_counter()                        tmp.append(round(end_time-start_time,3))          results.add_rows( tmp )     return results  In\u00a0[37]: Copied! <pre>allb = all_benchmark(tables)\nallb\n</pre> allb = all_benchmark(tables) allb Out[37]: ~rows#1234567891011 010000000.120.1210.1620.1220.2640.1380.1550.1270.2090.2370.1330.151 120000000.2370.2350.3110.2380.520.2660.2970.3410.4510.530.2610.285 250000000.6750.6980.9520.5941.6050.6590.8120.7191.2241.3530.6640.914 3100000001.3141.3321.7071.3323.0911.4631.7811.3662.3582.6381.4091.714 4200000002.5762.3133.112.3965.2072.5732.9212.4034.0414.6582.4632.808 5500000005.8965.827.735.95612.9097.457.275.98110.18311.5766.3727.414 In\u00a0[\u00a0]: Copied! <pre>\n</pre> In\u00a0[38]: Copied! <pre>def unique_benchmark(tables):\n    results = Table()\n    results.add_columns(\"rows\", *list(tables[0].columns))\n    \n    for table in tables:\n        length = len(table)\n\n        tmp = [len(table)]\n        for column in list(table.columns):\n            start_time = perf_counter()\n            try:\n                L = table[column].unique()\n                dt = perf_counter() - start_time\n            except MemoryError:\n                dt = -1\n            tmp.append(round(dt,3))\n            assert 0 &lt; len(L) &lt;= length    \n\n        results.add_rows( tmp )\n    return results\n</pre> def unique_benchmark(tables):     results = Table()     results.add_columns(\"rows\", *list(tables[0].columns))          for table in tables:         length = len(table)          tmp = [len(table)]         for column in list(table.columns):             start_time = perf_counter()             try:                 L = table[column].unique()                 dt = perf_counter() - start_time             except MemoryError:                 dt = -1             tmp.append(round(dt,3))             assert 0 &lt; len(L) &lt;= length              results.add_rows( tmp )     return results In\u00a0[39]: Copied! <pre>ubm = unique_benchmark(tables)\nubm\n</pre> ubm = unique_benchmark(tables) ubm Out[39]: ~rows#1234567891011 010000000.0220.0810.2480.0440.0160.0610.1150.1360.0960.0850.0940.447 120000000.1760.2710.5050.0870.0310.1240.2290.2790.1980.170.3051.471 250000000.1980.4991.2630.2180.0760.3110.570.6850.4740.4250.5952.744 3100000000.5021.1232.5350.4330.1550.6151.1281.3750.960.851.3165.826 4200000000.9562.3365.0350.8830.3191.2292.2682.7481.9131.7462.73311.883 5500000002.3956.01912.4992.1780.7643.0735.6086.8194.8284.2797.09730.511 In\u00a0[40]: Copied! <pre>def index_benchmark(tables):\n    results = Table()\n    results.add_columns(\"rows\", *list(tables[0].columns))\n    \n    for table in tables:\n\n        tmp = [len(table)]\n        for column in list(table.columns):\n            start_time = perf_counter()\n            try:\n                _ = table.index(column)\n                dt = perf_counter() - start_time\n            except MemoryError:\n                dt = -1\n            tmp.append(round(dt,3))\n            \n        results.add_rows( tmp )\n    return results\n</pre> def index_benchmark(tables):     results = Table()     results.add_columns(\"rows\", *list(tables[0].columns))          for table in tables:          tmp = [len(table)]         for column in list(table.columns):             start_time = perf_counter()             try:                 _ = table.index(column)                 dt = perf_counter() - start_time             except MemoryError:                 dt = -1             tmp.append(round(dt,3))                      results.add_rows( tmp )     return results   In\u00a0[41]: Copied! <pre>ibm = index_benchmark(tables)\nibm\n</pre> ibm = index_benchmark(tables) ibm Out[41]: ~rows#1234567891011 010000001.9491.7931.4321.1061.0511.231.3381.4931.4111.3031.9992.325 120000002.8833.5172.8562.2172.1242.4622.6762.9862.7092.6064.0494.461 250000006.3829.0497.0965.6285.3536.3126.6497.5216.716.45910.2710.747 31000000012.55318.50613.9511.33510.72412.50913.3315.05113.50212.89919.76921.999 42000000024.71737.89628.56822.66621.47226.32727.15730.06427.33225.82238.31143.399 55000000063.01697.07772.00755.60954.09961.79768.23675.0769.02266.15299.183109.969 <p>Multi-column index next:</p> In\u00a0[42]: Copied! <pre>def multi_column_index_benchmark(tables):\n    \n    selection = [\"4\", \"7\", \"8\", \"9\"]\n    results = Table()\n    results.add_columns(\"rows\", *range(1,len(selection)+1))\n    \n    for table in tables:\n\n        tmp = [len(table)]\n        for index in range(1,5):\n            start_time = perf_counter()\n            try:\n                _ = table.index(*selection[:index])\n                dt = perf_counter() - start_time\n            except MemoryError:\n                dt = -1\n            tmp.append(round(dt,3))\n            print('.', end='')\n            \n        results.add_rows( tmp )\n    return results\n</pre> def multi_column_index_benchmark(tables):          selection = [\"4\", \"7\", \"8\", \"9\"]     results = Table()     results.add_columns(\"rows\", *range(1,len(selection)+1))          for table in tables:          tmp = [len(table)]         for index in range(1,5):             start_time = perf_counter()             try:                 _ = table.index(*selection[:index])                 dt = perf_counter() - start_time             except MemoryError:                 dt = -1             tmp.append(round(dt,3))             print('.', end='')                      results.add_rows( tmp )     return results   In\u00a0[43]: Copied! <pre>mcib = multi_column_index_benchmark(tables)\nmcib\n</pre> mcib = multi_column_index_benchmark(tables) mcib <pre>........................</pre> Out[43]: #rows1234 010000001.0582.1333.2154.052 120000002.124.2786.5468.328 250000005.30310.8916.69320.793 31000000010.58122.40733.46241.91 42000000021.06445.95467.78184.828 55000000052.347109.551166.6211.053 In\u00a0[44]: Copied! <pre>def drop_duplicates_benchmark(tables):\n    results = Table()\n    results.add_columns(\"rows\", *list(tables[0].columns))\n    \n    for table in tables:\n        result = [len(table)]\n        cols = []\n        for name in list(table.columns):\n            cols.append(name)\n            start_time = perf_counter()\n            try:\n                _ = table.drop_duplicates(*cols)\n                dt = perf_counter() - start_time\n            except MemoryError:\n                dt = -1\n            result.append(round(dt,3))\n            print('.', end='')\n        \n        results.add_rows( result )\n    return results\n</pre> def drop_duplicates_benchmark(tables):     results = Table()     results.add_columns(\"rows\", *list(tables[0].columns))          for table in tables:         result = [len(table)]         cols = []         for name in list(table.columns):             cols.append(name)             start_time = perf_counter()             try:                 _ = table.drop_duplicates(*cols)                 dt = perf_counter() - start_time             except MemoryError:                 dt = -1             result.append(round(dt,3))             print('.', end='')                  results.add_rows( result )     return results   In\u00a0[45]: Copied! <pre>ddb = drop_duplicates_benchmark(tables)\nddb\n</pre> ddb = drop_duplicates_benchmark(tables) ddb <pre>........................................................................</pre> Out[45]: ~rows#1234567891011 010000001.7612.3583.3133.9014.6154.9615.8356.5347.4548.1088.8039.682 120000003.0114.936.9347.979.26410.26812.00613.51714.9216.63117.93219.493 250000006.82713.85318.63721.23724.54827.1131.15735.02638.99243.53146.02250.433 31000000013.23831.74641.14146.91753.17258.24167.99274.65182.7491.45897.666104.82 42000000025.93277.75100.34109.314123.514131.874148.432163.57179.121196.047208.686228.059 55000000064.237312.222364.886388.249429.724466.685494.418535.367581.666607.306634.343683.858"},{"location":"benchmarks/#benchmarks","title":"Benchmarks\u00b6","text":"<p>These benchmarks seek to establish the performance of tablite as a user sees it.</p> <p>Overview</p> Input/Output Various column functions Base functions Core functions - Save / Load .tpz format- Save tables to various formats- Import data from various formats - Setitem / getitem- iter- equal, not equal- copy- t += t- t *= t- contains- remove all- replace- index- unique- histogram- statistics- count - Setitem / getitem- iter / rows- equal, not equal- load- save- copy- stack- types- display_dict- show- to_dict- as_json_serializable- index - expression- filter- sort_index- reindex- drop_duplicates- sort- is_sorted- any- all- drop - replace- groupby- pivot- joins- lookup- replace missing values- transpose- pivot_transpose- diff"},{"location":"benchmarks/#input-output","title":"Input / Output\u00b6","text":""},{"location":"benchmarks/#create-tables-from-synthetic-data","title":"Create tables from synthetic data.\u00b6","text":""},{"location":"benchmarks/#save-load-tpz-format","title":"Save / Load .tpz format\u00b6","text":"<p>Without default compression settings (10% slower than uncompressed, 20% of uncompressed filesize)</p>"},{"location":"benchmarks/#save-load-tables-to-from-various-formats","title":"Save / load tables to / from various formats\u00b6","text":"<p>The handlers for saving / export are:</p> <ul> <li>to_sql</li> <li>to_json</li> <li>to_xls</li> <li>to_ods</li> <li>to_csv</li> <li>to_tsv</li> <li>to_text</li> <li>to_html</li> <li>to_hdf5</li> </ul>"},{"location":"benchmarks/#various-column-functions","title":"Various column functions\u00b6","text":"<ul> <li>Setitem / getitem</li> <li>iter</li> <li>equal, not equal</li> <li>copy</li> <li>t += t</li> <li>t *= t</li> <li>contains</li> <li>remove all</li> <li>replace</li> <li>index</li> <li>unique</li> <li>histogram</li> <li>statistics</li> <li>count</li> </ul>"},{"location":"benchmarks/#various-table-functions","title":"Various table functions\u00b6","text":""},{"location":"benchmarks/#slicing","title":"Slicing\u00b6","text":"<p>Slicing operations are used in many places.</p>"},{"location":"benchmarks/#tabletypes","title":"Table.types()\u00b6","text":"<p>Table.types() is implemented for near constant speed lookup.</p> <p>Here is an example:</p>"},{"location":"benchmarks/#tableany","title":"Table.any\u00b6","text":""},{"location":"benchmarks/#tableall","title":"Table.all\u00b6","text":""},{"location":"benchmarks/#tablefilter","title":"Table.filter\u00b6","text":""},{"location":"benchmarks/#tableunique","title":"Table.unique\u00b6","text":""},{"location":"benchmarks/#tableindex","title":"Table.index\u00b6","text":"<p>Single column index first:</p>"},{"location":"benchmarks/#drop-duplicates","title":"drop duplicates\u00b6","text":""},{"location":"changelog/","title":"Changelog","text":"Version Change 2023.9.0 Adding <code>Table.match</code> operation. 2023.8.0 Nim backend for csv importer.Improve excel importer.Improve slicing consistency.Logical cores re-enabled on *nix based systems.Filter is now type safe.Added merge utility.Various bugfixes. 2023.6.5 Fix issues with <code>get_headers</code> falling back to text reading when reading 0 lines of excel, fix issue where reading excel file would ignore file count, excel file reader now has parity for linecount selection. 2023.6.4 Fix a logic bug in <code>get_headers</code> that caused one extra line to be returned than requested. 2023.6.3 Updated the way reference counting works. Tablite now tracks references to used pages and cleans them up based on number of references to those pages in the current process. This change allows to handle deep table clones when sending tables via processes (pickling/unpickling), whereas previous implementation would corrupt all tables using same pages due to reference counting asserting that all tables are shallow copies to the same object. 2023.6.2 Updated <code>mplite</code> dependency, changed to soft version requirement to prevent pipeline freezes due to small bugfixes in <code>mplite</code>. 2023.6.1 Major change of the backend processes. Speed up of ~6x. For more see the release notes 2022.11.19 Fixed some memory leaks. 2022.11.18 <code>copy</code>, <code>filter</code>, <code>sort</code>, <code>any</code>, <code>all</code> methods now properly respects the table subclass.Filter for tables with under <code>SINGLE_PROCESSING_LIMIT</code> rows will run on same process to reduce overhead.Errors within child processes now properly propagate to parent.<code>Table.reset_storage(include_imports=True)</code> now allows the user to reset the storage but exclude any imported files by setting <code>include_imports=False</code> during <code>Table.reset(...)</code>.Bug: A column with <code>1,None,2</code> would be written to csv &amp; tsv as <code>\"1,None,2\"</code>. Now it is written <code>\"1,,2\"</code> where None means absent.Fix mp <code>join</code> producing mismatched columns lengths when different table lengths are used as an input or when join product is longer than the input table. 2022.11.17 <code>Table.load</code> now properly subclassess the table instead of always resulting in <code>tablite.Table</code>.<code>Table.from_*</code> methods now respect subclassess, fixed some <code>from_*</code> methods which were instance methods and not class methods.Fixed <code>Table.from_dict</code> only accepting <code>list</code> and <code>tuple</code> but not <code>tablite.Column</code> which is an equally valid type.Fix <code>lookup</code> parity in single process and multiple process outputs.Fix an issue with multiprocess <code>lookup</code> where no matches would throw instead of producing <code>None</code>.Fix an issue with filtering an empty table. 2022.11.16 Changed <code>join</code> to process 1M rows per task to avoid potential OOM on lower memory systems. Added <code>mp_merge_columns</code> to <code>MemoryManager</code> that merges column pages into a single column.Fix <code>join</code> parity in single process and multiple process outputs.Fix an issue with multiprocess <code>join</code> where no matches would throw instead of producing <code>None</code>. 2022.11.15 Bump <code>mplite</code> to avoid deadlock issues OS kill the process. 2022.11.14 Improve locking mechanism to allow retries when opening file as the previous solution could cause deadlocks when running multiple threads. 2022.11.13 Fix an issue with copying empty pages. 2022.11.12 Tablite now is now able to create it's own temporary directory. 2022.11.11 <code>text_reader</code> tqdm tracks the entire process now.  <code>text_reader</code> properly respects free memory in *nix based systems.  <code>text_reader</code> no longer discriminates against hyperthreaded cores. 2022.11.10 <code>get_headers</code> now uses plain <code>openpyxl</code> instead of <code>pyexcel</code> wrapper to speed up fetch times ~10x on certain files. 2022.11.9 <code>get_headers</code> can fail safe on unrecognized characters. 2022.11.8 Fix a bug with task size calculation on single core systems. 2022.11.7 Added <code>TABLITE_TMPDIR</code> environment variable for setting tablite work directory.  Characters that fail to be read text reader due to improper encoding will be skipped.  Fixed an issue where single column text files with no column delimiters would be imported as empty tables. 2022.11.6 Date inference fix 2022.11.5 Fixed negative slicing issues 2022.11.4 Transpose API changes:  <code>table.transpose(...)</code> was renamed to <code>table.pivot_transpose(...)</code>  new <code>table.transpose()</code> and <code>table.T</code> were added, it's functionality acts similarly to <code>numpy.T</code>, the column headers are used the first row in the table when transposing. 2022.11.3 Bugfix for non-ascii encoded strings during <code>t.add_rows(...)</code> 2022.11.2 As <code>utf-8</code> is ascii compatible, the file reader utils selects <code>utf-8</code> instead of <code>ascii</code> as a default. 2022.11.1 bugfix in <code>datatypes.infer()</code> where 1 was inferred as int, not float. 2022.11.0 New table features: <code>Table.diff(other, columns=...)</code>, <code>table.remove_duplicates_rows()</code>, <code>table.drop_na(*arg)</code>,<code>table.replace(target,replacement)</code>, <code>table.imputation(sources, targets, methods=...)</code>, <code>table.to_pandas()</code> and <code>Table.from_pandas(pd.DataFrame)</code>,<code>table.to_dict(columns, slice)</code>, <code>Table.from_dict()</code>,<code>table.transpose(columns, keep, ...)</code>, New column features:  <code>Column.count(item)</code>, <code>Column[:]</code> is guaranteed to return a python list.<code>Column.to_numpy(slice)</code> returns <code>np.ndarray</code>.  new <code>tools</code> library: <code>from tablite import tools</code> with:  <code>date_range(start,end)</code>, <code>xround(value, multiple, up=None)</code>, and,  <code>guess</code> as short-cut for <code>Datatypes.guess(...)</code>. bugfixes:  <code>__eq__</code> was updated but missed <code>__ne__</code>.<code>in</code> operator in filter would crash if datatypes were not strings. 2022.10.11 filter now accepts any expression (str) that can be compiled by pythons compiler 2022.10.11 Bugfix for <code>.any</code> and <code>.all</code>. The code now executes much faster 2022.10.10 Bugfix for <code>Table.import_file</code>: <code>import_as</code> has been removed from keywords. 2022.10.10 All Table functions now have tqdm progressbar. 2022.10.10 More robust calculation for task size for multiprocessing. 2022.10.10 Dependency update: mplite==1.2.0 is now required. 2022.10.9 Bugfix for <code>Table.import_file</code>: files with duplicate header names would only have last duplicate name imported.Now the headers are made unique using <code>name_x</code> where x is a number. 2022.10.8 Bugfix for groupby: Where keys are empty error should have been raised.Where there are no functions, unique keypairs are returned. 2022.10.7 Bugfix for Column.statistics() for an empty column 2022.10.6 Bugfix for <code>__setitem__</code>: tbl['a'] = [] is now seen as <code>tbl.add_column('a')</code>Bugfix for <code>__getitem__</code>: calling a missing key raises keyerror. 2022.10.5 Bugfix for summary statistics. 2022.10.4 Bugfix for join shortcut. 2022.10.3 Bugfix for DataTypes where bool was evaluated wrongly 2022.10.0 Added ability to reindex in <code>table.reindex(index=[0,1...,n,n-1])</code> 2022.9.0 Added ability to store python objects (example).Added warning when user iterates over non-rectangular dataset. 2022.8.0 Added <code>table.export(path)</code> which exports tablite Tables to file format given by the file extension. For example <code>my_table.export('example.xlsx')</code>.supported formats are: <code>json</code>, <code>html</code>, <code>xlsx</code>, <code>xls</code>, <code>csv</code>, <code>tsv</code>, <code>txt</code>, <code>ods</code> and <code>sql</code>. 2022.7.8 Added ability to forward <code>tqdm</code> progressbar into <code>Table.import_file(..., tqdm=your_tqdm)</code>, so that Jupyter notebook can use it in <code>display</code>-methods. 2022.7.7 Added method <code>Table.to_sql()</code> for export to ANSI-92 SQL enginesBugfix on to_json for <code>timedelta</code>. Jupyter notebook provides nice view using <code>Table._repr_html_()</code> JS-users can use <code>.as_json_serializable</code> where suitable. 2022.7.6 get_headers now takes argument <code>(path, linecount=10)</code> 2022.7.5 added helper <code>Table.as_json_serializable</code> as Jupyterkernel compat. 2022.7.4 adder helper <code>Table.to_dict</code>, and updated <code>Table.to_json</code> 2022.7.3 table.to_json now takes kwargs: <code>row_count</code>, <code>columns</code>, <code>slice_</code>, <code>start_on</code> 2022.7.2 documentation update. 2022.7.1 minor bugfix. 2022.7.0 BREAKING CHANGES- Tablite now uses HDF5 as backend. - Has multiprocessing enabled by default. - Is 20x faster. - Completely new API. 2022.6.0 <code>DataTypes.guess([list of strings])</code> returns the best matching python datatype."},{"location":"tutorial/","title":"Tutorial","text":"In\u00a0[1]: Copied! <pre>from tablite import Table\n\n## To create a tablite table is as simple as populating a dictionary:\nt = Table({'A':[1,2,3], 'B':['a','b','c']})\n</pre> from tablite import Table  ## To create a tablite table is as simple as populating a dictionary: t = Table({'A':[1,2,3], 'B':['a','b','c']}) In\u00a0[2]: Copied! <pre>## In this notebook we can show tables in the HTML style:\nt\n</pre> ## In this notebook we can show tables in the HTML style: t Out[2]: #AB 01a 12b 23c In\u00a0[3]: Copied! <pre>## or the ascii style:\nt.show()\n</pre> ## or the ascii style: t.show() <pre>+==+=+=+\n|# |A|B|\n+--+-+-+\n| 0|1|a|\n| 1|2|b|\n| 2|3|c|\n+==+=+=+\n</pre> In\u00a0[4]: Copied! <pre>## or if you'd like to inspect the table, use:\nprint(str(t))\n</pre> ## or if you'd like to inspect the table, use: print(str(t)) <pre>Table(2 columns, 3 rows)\n</pre> In\u00a0[5]: Copied! <pre>## You can also add all columns at once (slower) if you prefer. \nt2 = Table(headers=('A','B'), rows=((1,'a'),(2,'b'),(3,'c')))\nassert t==t2\n</pre> ## You can also add all columns at once (slower) if you prefer.  t2 = Table(headers=('A','B'), rows=((1,'a'),(2,'b'),(3,'c'))) assert t==t2 In\u00a0[6]: Copied! <pre>## or load data:\nt3 = Table.from_file('tests/data/book1.csv')\n\n## to view any table in the notebook just let jupyter show the table. If you're using the terminal use .show(). \n## Note that show gives either first and last 7 rows or the whole table if it is less than 20 rows.\nt3\n</pre> ## or load data: t3 = Table.from_file('tests/data/book1.csv')  ## to view any table in the notebook just let jupyter show the table. If you're using the terminal use .show().  ## Note that show gives either first and last 7 rows or the whole table if it is less than 20 rows. t3 <pre>Collecting tasks: 'tests/data/book1.csv'\nDumping tasks: 'tests/data/book1.csv'\n</pre> <pre>importing file: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 1/1 [00:00&lt;00:00, 487.82it/s]\n</pre> Out[6]: #abcdef 010.0606060610.0909090910.1212121210.1515151520.181818182 120.1212121210.2424242420.4848484850.969696971.939393939 230.2424242420.4848484850.969696971.9393939393.878787879 340.4848484850.969696971.9393939393.8787878797.757575758 450.969696971.9393939393.8787878797.75757575815.51515152 561.9393939393.8787878797.75757575815.5151515231.03030303 673.8787878797.75757575815.5151515231.0303030362.06060606.....................383916659267088.033318534175.066637068350.0133274000000.0266548000000.0394033318534175.066637068350.0133274000000.0266548000000.0533097000000.0404166637068350.0133274000000.0266548000000.0533097000000.01066190000000.04142133274000000.0266548000000.0533097000000.01066190000000.02132390000000.04243266548000000.0533097000000.01066190000000.02132390000000.04264770000000.04344533097000000.01066190000000.02132390000000.04264770000000.08529540000000.044451066190000000.02132390000000.04264770000000.08529540000000.017059100000000.0 In\u00a0[7]: Copied! <pre>## should you however want to select the headers instead of importing everything\n## (which maybe timeconsuming), simply use get_headers(path)\nfrom tablite.tools import get_headers\nfrom pathlib import Path\npath = Path('tests/data/book1.csv')\nsample = get_headers(path, linecount=5)\nprint(f\"sample is of type {type(sample)} and has the following entries:\")\nfor k,v in sample.items():\n    print(k)\n    if isinstance(v,list):\n        for r in sample[k]:\n            print(\"\\t\", r)\n</pre> ## should you however want to select the headers instead of importing everything ## (which maybe timeconsuming), simply use get_headers(path) from tablite.tools import get_headers from pathlib import Path path = Path('tests/data/book1.csv') sample = get_headers(path, linecount=5) print(f\"sample is of type {type(sample)} and has the following entries:\") for k,v in sample.items():     print(k)     if isinstance(v,list):         for r in sample[k]:             print(\"\\t\", r) <pre>sample is of type &lt;class 'dict'&gt; and has the following entries:\ndelimiter\nbook1.csv\n\t ['a', 'b', 'c', 'd', 'e', 'f']\n\t ['1', '0.060606061', '0.090909091', '0.121212121', '0.151515152', '0.181818182']\n\t ['2', '0.121212121', '0.242424242', '0.484848485', '0.96969697', '1.939393939']\n\t ['3', '0.242424242', '0.484848485', '0.96969697', '1.939393939', '3.878787879']\n\t ['4', '0.484848485', '0.96969697', '1.939393939', '3.878787879', '7.757575758']\n\t ['5', '0.96969697', '1.939393939', '3.878787879', '7.757575758', '15.51515152']\n</pre> In\u00a0[8]: Copied! <pre>## to extend a table by adding columns, use t[new] = [new values]\nt['C'] = [4,5,6]\n## but make sure the column has the same length as the rest of the table!\nt\n</pre> ## to extend a table by adding columns, use t[new] = [new values] t['C'] = [4,5,6] ## but make sure the column has the same length as the rest of the table! t Out[8]: #ABC 01a4 12b5 23c6 In\u00a0[9]: Copied! <pre>## should you want to mix datatypes, tablite will not complain:\nfrom datetime import datetime, date,time,timedelta\nimport numpy as np\n## What you put in ...\nt4 = Table()\nt4['mixed'] = [\n    -1,0,1,  # regular integers\n    -12345678909876543211234567890987654321,  # very very large integer\n    None,np.nan,  # null values \n    \"one\", \"\",  # strings\n    True,False,  # booleans\n    float('inf'), 0.01,  # floats\n    date(2000,1,1),   # date\n    datetime(2002,2,3,23,0,4,6660),  # datetime\n    time(12,12,12),  # time\n    timedelta(days=3, seconds=5678)  # timedelta\n]\n## ... is exactly what you get out:\nt4\n</pre> ## should you want to mix datatypes, tablite will not complain: from datetime import datetime, date,time,timedelta import numpy as np ## What you put in ... t4 = Table() t4['mixed'] = [     -1,0,1,  # regular integers     -12345678909876543211234567890987654321,  # very very large integer     None,np.nan,  # null values      \"one\", \"\",  # strings     True,False,  # booleans     float('inf'), 0.01,  # floats     date(2000,1,1),   # date     datetime(2002,2,3,23,0,4,6660),  # datetime     time(12,12,12),  # time     timedelta(days=3, seconds=5678)  # timedelta ] ## ... is exactly what you get out: t4 Out[9]: #mixed 0-1 10 21 3-12345678909876543211234567890987654321 4None 5nan 6one 7 8True 9False10inf110.01122000-01-01132002-02-03 23:00:04.0066601412:12:12153 days, 1:34:38 In\u00a0[10]: Copied! <pre>## also if you claim the values back as a python list:\nfor item in list(t4['mixed']):\n    print(item)\n</pre> ## also if you claim the values back as a python list: for item in list(t4['mixed']):     print(item) <pre>-1\n0\n1\n-12345678909876543211234567890987654321\nNone\nnan\none\n\nTrue\nFalse\ninf\n0.01\n2000-01-01\n2002-02-03 23:00:04.006660\n12:12:12\n3 days, 1:34:38\n</pre> <p>The column itself (<code>__repr__</code>) shows us the <code>pid</code>, <code>file location</code> and the entries, so you know exactly what you're working with.</p> In\u00a0[11]: Copied! <pre>t4['mixed']\n</pre> t4['mixed'] Out[11]: <pre>Column(/tmp/tablite-tmp/pid-54911, [-1 0 1 -12345678909876543211234567890987654321 None nan 'one' '' True\n False inf 0.01 datetime.date(2000, 1, 1)\n datetime.datetime(2002, 2, 3, 23, 0, 4, 6660) datetime.time(12, 12, 12)\n datetime.timedelta(days=3, seconds=5678)])</pre> In\u00a0[12]: Copied! <pre>## to view the datatypes in a column, use Column.types()\ntype_dict = t4['mixed'].types()\nfor k,v in type_dict.items():\n    print(k,v)\n</pre> ## to view the datatypes in a column, use Column.types() type_dict = t4['mixed'].types() for k,v in type_dict.items():     print(k,v) <pre>&lt;class 'int'&gt; 4\n&lt;class 'NoneType'&gt; 1\n&lt;class 'float'&gt; 3\n&lt;class 'str'&gt; 2\n&lt;class 'bool'&gt; 2\n&lt;class 'datetime.date'&gt; 1\n&lt;class 'datetime.datetime'&gt; 1\n&lt;class 'datetime.time'&gt; 1\n&lt;class 'datetime.timedelta'&gt; 1\n</pre> In\u00a0[13]: Copied! <pre>## You may have noticed that all datatypes in t3 where identified as floats, despite their origin from a text type file.\n## This is because tablite guesses the most probable datatype using the `.guess` function on each column.\n## You can use the .guess function like this:\nfrom tablite import DataTypes\nt3['a'] = DataTypes.guess(t3['a'])\n## You can also convert the datatype using a list comprehension\nt3['b'] = [float(v) for v in t3['b']]\nt3\n</pre> ## You may have noticed that all datatypes in t3 where identified as floats, despite their origin from a text type file. ## This is because tablite guesses the most probable datatype using the `.guess` function on each column. ## You can use the .guess function like this: from tablite import DataTypes t3['a'] = DataTypes.guess(t3['a']) ## You can also convert the datatype using a list comprehension t3['b'] = [float(v) for v in t3['b']] t3 Out[13]: #abcdef 010.0606060610.0909090910.1212121210.1515151520.181818182 120.1212121210.2424242420.4848484850.969696971.939393939 230.2424242420.4848484850.969696971.9393939393.878787879 340.4848484850.969696971.9393939393.8787878797.757575758 450.969696971.9393939393.8787878797.75757575815.51515152 561.9393939393.8787878797.75757575815.5151515231.03030303 673.8787878797.75757575815.5151515231.0303030362.06060606.....................383916659267088.033318534175.066637068350.0133274000000.0266548000000.0394033318534175.066637068350.0133274000000.0266548000000.0533097000000.0404166637068350.0133274000000.0266548000000.0533097000000.01066190000000.04142133274000000.0266548000000.0533097000000.01066190000000.02132390000000.04243266548000000.0533097000000.01066190000000.02132390000000.04264770000000.04344533097000000.01066190000000.02132390000000.04264770000000.08529540000000.044451066190000000.02132390000000.04264770000000.08529540000000.017059100000000.0 In\u00a0[14]: Copied! <pre>t = Table()\nfor column_name in 'abcde':\n    t[column_name] =[i for i in range(5)]\n</pre> t = Table() for column_name in 'abcde':     t[column_name] =[i for i in range(5)] <p>(2) we want to add two new columns using the functions:</p> In\u00a0[15]: Copied! <pre>def f1(a,b,c):\n    return a+b+c+1\ndef f2(b,c,d):\n    return b*c*d\n</pre> def f1(a,b,c):     return a+b+c+1 def f2(b,c,d):     return b*c*d <p>(3) and we want to compute two new columns <code>f</code> and <code>g</code>:</p> In\u00a0[16]: Copied! <pre>t.add_columns('f', 'g')\n</pre> t.add_columns('f', 'g') <p>(4) we can now use the filter, to iterate over the table, and add the values to the two new columns:</p> In\u00a0[17]: Copied! <pre>f,g=[],[]\nfor row in t['a', 'b', 'c', 'd'].rows:\n    a, b, c, d = row\n\n    f.append(f1(a, b, c))\n    g.append(f2(b, c, d))\nt['f'] = f\nt['g'] = g\n\nassert len(t) == 5\nassert list(t.columns) == list('abcdefg')\nt\n</pre> f,g=[],[] for row in t['a', 'b', 'c', 'd'].rows:     a, b, c, d = row      f.append(f1(a, b, c))     g.append(f2(b, c, d)) t['f'] = f t['g'] = g  assert len(t) == 5 assert list(t.columns) == list('abcdefg') t Out[17]: #abcdefg 00000010 11111141 22222278 3333331027 4444441364 <p>Take note that if your dataset is assymmetric, a warning will be show:</p> In\u00a0[18]: Copied! <pre>assymmetric_table = Table({'a':[1,2,3], 'b':[1,2]})\nfor row in assymmetric_table.rows:\n    print(row)\n## warning at the bottom ---v\n</pre> assymmetric_table = Table({'a':[1,2,3], 'b':[1,2]}) for row in assymmetric_table.rows:     print(row) ## warning at the bottom ---v <pre>[1, 1]\n[2, 2]\n[3, None]\n</pre> <pre>/home/bjorn/github/tablite/tablite/base.py:1188: UserWarning: Column b has length 2 / 3. None will appear as fill value.\n  warnings.warn(f\"Column {name} has length {len(column)} / {n_max}. None will appear as fill value.\")\n</pre> In\u00a0[19]: Copied! <pre>table7 = Table(columns={\n'A': [1,1,2,2,3,4],\n'B': [1,1,2,2,30,40],\n'C': [-1,-2,-3,-4,-5,-6]\n})\nindex = table7.index('A', 'B')\nfor k, v in index.items():\n    print(\"key\", k, \"indices\", v)\n</pre> table7 = Table(columns={ 'A': [1,1,2,2,3,4], 'B': [1,1,2,2,30,40], 'C': [-1,-2,-3,-4,-5,-6] }) index = table7.index('A', 'B') for k, v in index.items():     print(\"key\", k, \"indices\", v) <pre>key (1, 1) indices [0, 1]\nkey (2, 2) indices [2, 3]\nkey (3, 30) indices [4]\nkey (4, 40) indices [5]\n</pre> <p>The keys are created for each unique column-key-pair, and the value is the index where the key is found. To fetch all rows for key <code>(2,2)</code>, we can use:</p> In\u00a0[20]: Copied! <pre>for ix, row in enumerate(table7.rows):\n    if ix in index[(2,2)]:\n        print(row)\n</pre> for ix, row in enumerate(table7.rows):     if ix in index[(2,2)]:         print(row) <pre>[2, 2, -3]\n[2, 2, -4]\n</pre> In\u00a0[21]: Copied! <pre>## to append one table to another, use + or += \nprint('length before:', len(t3))  # length before: 45\nt5 = t3 + t3  \nprint('length after +', len(t5))  # length after + 90\nt5 += t3 \nprint('length after +=', len(t5))  # length after += 135\n## if you need a lot of numbers for a test, you can repeat a table using * and *=\nt5 *= 1_000\nprint('length after +=', len(t5))  # length after += 135000\n</pre> ## to append one table to another, use + or +=  print('length before:', len(t3))  # length before: 45 t5 = t3 + t3   print('length after +', len(t5))  # length after + 90 t5 += t3  print('length after +=', len(t5))  # length after += 135 ## if you need a lot of numbers for a test, you can repeat a table using * and *= t5 *= 1_000 print('length after +=', len(t5))  # length after += 135000 <pre>length before: 45\nlength after + 90\nlength after += 135\nlength after += 135000\n</pre> In\u00a0[22]: Copied! <pre>t5\n</pre> t5   Out[22]: #abcdef       010.0606060610.0909090910.1212121210.1515151520.181818182       120.1212121210.2424242420.4848484850.969696971.939393939       230.2424242420.4848484850.969696971.9393939393.878787879       340.4848484850.969696971.9393939393.8787878797.757575758       450.969696971.9393939393.8787878797.75757575815.51515152       561.9393939393.8787878797.75757575815.5151515231.03030303       673.8787878797.75757575815.5151515231.0303030362.06060606..................... 134,9933916659267088.033318534175.066637068350.0133274000000.0266548000000.0 134,9944033318534175.066637068350.0133274000000.0266548000000.0533097000000.0 134,9954166637068350.0133274000000.0266548000000.0533097000000.01066190000000.0 134,99642133274000000.0266548000000.0533097000000.01066190000000.02132390000000.0 134,99743266548000000.0533097000000.01066190000000.02132390000000.04264770000000.0 134,99844533097000000.01066190000000.02132390000000.04264770000000.08529540000000.0 134,999451066190000000.02132390000000.04264770000000.08529540000000.017059100000000.0 In\u00a0[23]: Copied! <pre>## if your are in doubt whether your tables will be the same you can use .stack(other)\nassert t.columns != t2.columns  # compares list of column names.\nt6 = t.stack(t2)\nt6\n</pre> ## if your are in doubt whether your tables will be the same you can use .stack(other) assert t.columns != t2.columns  # compares list of column names. t6 = t.stack(t2) t6 Out[23]: #abcdefgAB 00000010NoneNone 11111141NoneNone 22222278NoneNone 3333331027NoneNone 4444441364NoneNone 5NoneNoneNoneNoneNoneNoneNone1a 6NoneNoneNoneNoneNoneNoneNone2b 7NoneNoneNoneNoneNoneNoneNone3c In\u00a0[24]: Copied! <pre>## As you can see above, t6['C'] is padded with \"None\" where t2 was missing the columns.\n\n## if you need a more detailed view of the columns you can iterate:\nfor name in t.columns:\n    col_from_t = t[name]\n    if name in t2.columns:\n        col_from_t2 = t2[name]\n        print(name, col_from_t == col_from_t2)\n    else:\n        print(name, \"not in t2\")\n</pre> ## As you can see above, t6['C'] is padded with \"None\" where t2 was missing the columns.  ## if you need a more detailed view of the columns you can iterate: for name in t.columns:     col_from_t = t[name]     if name in t2.columns:         col_from_t2 = t2[name]         print(name, col_from_t == col_from_t2)     else:         print(name, \"not in t2\") <pre>a not in t2\nb not in t2\nc not in t2\nd not in t2\ne not in t2\nf not in t2\ng not in t2\n</pre> In\u00a0[25]: Copied! <pre>## to make a copy of a table, use table.copy()\nt3_copy = t3.copy()\n\n## you can also perform multi criteria selections using getitem [ ... ]\nt3_slice = t3['a','b','d', 5:25:5]\nt3_slice\n</pre> ## to make a copy of a table, use table.copy() t3_copy = t3.copy()  ## you can also perform multi criteria selections using getitem [ ... ] t3_slice = t3['a','b','d', 5:25:5] t3_slice Out[25]: #abd 061.9393939397.757575758 11162.06060606248.2424242 2161985.9393947943.757576 32163550.06061254200.2424 In\u00a0[26]: Copied! <pre>##deleting items also works the same way:\ndel t3_slice[1:3]  # delete row number 2 &amp; 3 \nt3_slice\n</pre> ##deleting items also works the same way: del t3_slice[1:3]  # delete row number 2 &amp; 3  t3_slice Out[26]: #abd 061.9393939397.757575758 12163550.06061254200.2424 In\u00a0[27]: Copied! <pre>## to wipe a table, use .clear:\nt3_slice.clear()\nt3_slice\n</pre> ## to wipe a table, use .clear: t3_slice.clear() t3_slice Out[27]: Empty Table In\u00a0[28]: Copied! <pre>## tablite uses .npy for storage because it is fast.\n## this means you can make a table persistent using .save\nlocal_file = Path(\"local_file.tpz\")\nt5.save(local_file)\n\nold_t5 = Table.load(local_file)\nprint(\"the t5 table had\", len(old_t5), \"rows\")  # the t5 table had 135000 rows\n\ndel old_t5  # only removes the in-memory object\n\nprint(\"old_t5 still exists?\", local_file.exists())\nprint(\"path:\", local_file)\n\nimport os\nos.remove(local_file)\n</pre> ## tablite uses .npy for storage because it is fast. ## this means you can make a table persistent using .save local_file = Path(\"local_file.tpz\") t5.save(local_file)  old_t5 = Table.load(local_file) print(\"the t5 table had\", len(old_t5), \"rows\")  # the t5 table had 135000 rows  del old_t5  # only removes the in-memory object  print(\"old_t5 still exists?\", local_file.exists()) print(\"path:\", local_file)  import os os.remove(local_file) <pre>loading 'local_file.tpz' file:  55%|\u2588\u2588\u2588\u2588\u2588\u258d    | 9851/18000 [00:02&lt;00:01, 4386.96it/s]</pre> <pre>loading 'local_file.tpz' file: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 18000/18000 [00:04&lt;00:00, 4417.27it/s]\n</pre> <pre>the t5 table had 135000 rows\nold_t5 still exists? True\npath: local_file.tpz\n</pre> <p>If you want to save a table from one session to another use <code>save=True</code>. This tells the garbage collector to leave the tablite Table on disk, so you can load it again without changing your code.</p> <p>For example:</p> <p>First time you run <code>t = Table.import_file(....big.csv)</code> it may take a minute or two.</p> <p>If you then add <code>t.save=True</code> and restart python, the second time you run  <code>t = Table.import_file(....big.csv)</code> it will take a few milliseconds instead of minutes.</p> In\u00a0[29]: Copied! <pre>unfiltered = Table({'a':[1,2,3,4], 'b':[10,20,30,40]})\n</pre> unfiltered = Table({'a':[1,2,3,4], 'b':[10,20,30,40]}) In\u00a0[30]: Copied! <pre>true,false = unfiltered.filter(\n    [\n        {\"column1\": 'a', \"criteria\":\"&gt;=\", 'value2':3}\n    ], filter_type='all'\n)\n</pre> true,false = unfiltered.filter(     [         {\"column1\": 'a', \"criteria\":\"&gt;=\", 'value2':3}     ], filter_type='all' ) In\u00a0[31]: Copied! <pre>true\n</pre> true Out[31]: #ab 0330 1440 In\u00a0[32]: Copied! <pre>false.show()  # using show here to show that terminal users can have a nice view too.\n</pre> false.show()  # using show here to show that terminal users can have a nice view too. <pre>+==+=+==+\n|# |a|b |\n+--+-+--+\n| 0|1|10|\n| 1|2|20|\n+==+=+==+\n</pre> In\u00a0[33]: Copied! <pre>ty = Table({'a':[1,2,3,4],'b': [10,20,30,40]})\n</pre> ty = Table({'a':[1,2,3,4],'b': [10,20,30,40]}) In\u00a0[34]: Copied! <pre>## typical python\nany(i &gt; 3 for i in ty['a'])\n</pre> ## typical python any(i &gt; 3 for i in ty['a']) Out[34]: <pre>True</pre> In\u00a0[35]: Copied! <pre>## hereby you can do:\nany( ty.any(**{'a':lambda x:x&gt;3}).rows )\n</pre> ## hereby you can do: any( ty.any(**{'a':lambda x:x&gt;3}).rows ) Out[35]: <pre>True</pre> In\u00a0[36]: Copied! <pre>## if you have multiple criteria this also works:\nall( ty.all(**{'a': lambda x:x&gt;=2, 'b': lambda x:x&lt;=30}).rows )\n</pre> ## if you have multiple criteria this also works: all( ty.all(**{'a': lambda x:x&gt;=2, 'b': lambda x:x&lt;=30}).rows ) Out[36]: <pre>True</pre> In\u00a0[37]: Copied! <pre>## or this if you want to see the table.\nty.all(a=lambda x:x&gt;2, b=lambda x:x&lt;=30)\n</pre> ## or this if you want to see the table. ty.all(a=lambda x:x&gt;2, b=lambda x:x&lt;=30) Out[37]: #ab 0330 In\u00a0[38]: Copied! <pre>## As `all` and `any` returns tables, this also means that you can chain operations:\nty.any(a=lambda x:x&gt;2).any(b=30)\n</pre> ## As `all` and `any` returns tables, this also means that you can chain operations: ty.any(a=lambda x:x&gt;2).any(b=30) Out[38]: #ab 0330 In\u00a0[39]: Copied! <pre>table = Table({\n    'A':[ 1, None, 8, 3, 4, 6,  5,  7,  9],\n    'B':[10,'100', 1, 1, 1, 1, 10, 10, 10],\n    'C':[ 0,    1, 0, 1, 0, 1,  0,  1,  0],\n})\ntable\n</pre> table = Table({     'A':[ 1, None, 8, 3, 4, 6,  5,  7,  9],     'B':[10,'100', 1, 1, 1, 1, 10, 10, 10],     'C':[ 0,    1, 0, 1, 0, 1,  0,  1,  0], }) table Out[39]: #ABC 01100 1None1001 2810 3311 4410 5611 65100 77101 89100 In\u00a0[40]: Copied! <pre>sort_order = {'B': False, 'C': False, 'A': False}\nassert not table.is_sorted(mapping=sort_order)\n\nsorted_table = table.sort(mapping=sort_order)\nsorted_table\n</pre> sort_order = {'B': False, 'C': False, 'A': False} assert not table.is_sorted(mapping=sort_order)  sorted_table = table.sort(mapping=sort_order) sorted_table <pre>creating sort index: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 3/3 [00:00&lt;00:00, 2719.45it/s]\ncreating sort index: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 3/3 [00:00&lt;00:00, 3434.20it/s]\njoin: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 3/3 [00:00&lt;00:00, 1902.47it/s]\n</pre> <p>Sort is reasonable effective as it uses multiprocessing above a million fields.</p> <p>Hint: You can set this limit in <code>tablite.config</code>, like this:</p> In\u00a0[41]: Copied! <pre>from tablite.config import Config\nprint(f\"multiprocessing is used above {Config.SINGLE_PROCESSING_LIMIT:,} fields\")\n</pre> from tablite.config import Config print(f\"multiprocessing is used above {Config.SINGLE_PROCESSING_LIMIT:,} fields\") <pre>multiprocessing is used above 1,000,000 fields\n</pre> In\u00a0[42]: Copied! <pre>import math\nn = math.ceil(1_000_000 / (9*3))\n\ntable = Table({\n    'A':[ 1, None, 8, 3, 4, 6,  5,  7,  9]*n,\n    'B':[10,'100', 1, 1, 1, 1, 10, 10, 10]*n,\n    'C':[ 0,    1, 0, 1, 0, 1,  0,  1,  0]*n,\n})\ntable\n</pre> import math n = math.ceil(1_000_000 / (9*3))  table = Table({     'A':[ 1, None, 8, 3, 4, 6,  5,  7,  9]*n,     'B':[10,'100', 1, 1, 1, 1, 10, 10, 10]*n,     'C':[ 0,    1, 0, 1, 0, 1,  0,  1,  0]*n, }) table Out[42]: #ABC       01100       1None1001       2810       3311       4410       5611       65100............ 333,335810 333,336311 333,337410 333,338611 333,3395100 333,3407101 333,3419100 In\u00a0[43]: Copied! <pre>import time as cputime\nstart = cputime.time()\nsort_order = {'B': False, 'C': False, 'A': False}\nsorted_table = table.sort(mapping=sort_order)  # sorts 1M values.\nprint(\"table sorting took \", round(cputime.time() - start,3), \"secs\")\nsorted_table\n</pre> import time as cputime start = cputime.time() sort_order = {'B': False, 'C': False, 'A': False} sorted_table = table.sort(mapping=sort_order)  # sorts 1M values. print(\"table sorting took \", round(cputime.time() - start,3), \"secs\") sorted_table <pre>creating sort index: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 3/3 [00:00&lt;00:00,  4.20it/s]\njoin: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 3/3 [00:00&lt;00:00, 18.17it/s]</pre> <pre>table sorting took  0.913 secs\n</pre> <pre>\n</pre> In\u00a0[44]: Copied! <pre>n = math.ceil(1_000_000 / (9*3))\n\ntable = Table({\n    'A':[ 1, None, 8, 3, 4, 6,  5,  7,  9]*n,\n    'B':[10,'100', 1, 1, 1, 1, 10, 10, 10]*n,\n    'C':[ 0,    1, 0, 1, 0, 1,  0,  1,  0]*n,\n})\ntable\n</pre> n = math.ceil(1_000_000 / (9*3))  table = Table({     'A':[ 1, None, 8, 3, 4, 6,  5,  7,  9]*n,     'B':[10,'100', 1, 1, 1, 1, 10, 10, 10]*n,     'C':[ 0,    1, 0, 1, 0, 1,  0,  1,  0]*n, }) table  Out[44]: #ABC       01100       1None1001       2810       3311       4410       5611       65100............ 333,335810 333,336311 333,337410 333,338611 333,3395100 333,3407101 333,3419100 In\u00a0[45]: Copied! <pre>from tablite import GroupBy as gb\ngrpby = table.groupby(keys=['C', 'B'], functions=[('A', gb.count)])\ngrpby\n</pre> from tablite import GroupBy as gb grpby = table.groupby(keys=['C', 'B'], functions=[('A', gb.count)]) grpby <pre>groupby: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 333342/333342 [00:00&lt;00:00, 427322.50it/s]\n</pre> Out[45]: #CBCount(A) 0010111114 1110037038 20174076 31174076 411037038 <p>Here is the list of groupby functions:</p> <pre><code>class GroupBy(object):    \n    max = Max  # shortcuts to avoid having to type a long list of imports.\n    min = Min\n    sum = Sum\n    product = Product\n    first = First\n    last = Last\n    count = Count\n    count_unique = CountUnique\n    avg = Average\n    stdev = StandardDeviation\n    median = Median\n    mode = Mode\n</code></pre> In\u00a0[46]: Copied! <pre>t = Table({\n    'A':[1, 1, 2, 2, 3, 3] * 2,\n    'B':[1, 2, 3, 4, 5, 6] * 2,\n    'C':[6, 5, 4, 3, 2, 1] * 2,\n})\nt\n</pre> t = Table({     'A':[1, 1, 2, 2, 3, 3] * 2,     'B':[1, 2, 3, 4, 5, 6] * 2,     'C':[6, 5, 4, 3, 2, 1] * 2, }) t Out[46]: #ABC 0116 1125 2234 3243 4352 5361 6116 7125 8234 92431035211361 In\u00a0[47]: Copied! <pre>t2 = t.pivot(rows=['C'], columns=['A'], functions=[('B', gb.sum), ('B', gb.count)], values_as_rows=False)\nt2\n</pre> t2 = t.pivot(rows=['C'], columns=['A'], functions=[('B', gb.sum), ('B', gb.count)], values_as_rows=False) t2 <pre>pivot: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 14/14 [00:00&lt;00:00, 3643.83it/s]\n</pre> Out[47]: #CSum(B,A=1)Count(B,A=1)Sum(B,A=2)Count(B,A=2)Sum(B,A=3)Count(B,A=3) 0622NoneNoneNoneNone 1542NoneNoneNoneNone 24NoneNone62NoneNone 33NoneNone82NoneNone 42NoneNoneNoneNone102 51NoneNoneNoneNone122 In\u00a0[48]: Copied! <pre>numbers = Table()\nnumbers.add_column('number', data=[      1,      2,       3,       4,   None])\nnumbers.add_column('colour', data=['black', 'blue', 'white', 'white', 'blue'])\n\nletters = Table()\nletters.add_column('letter', data=[  'a',     'b',      'c',     'd',   None])\nletters.add_column('color', data=['blue', 'white', 'orange', 'white', 'blue'])\n</pre> numbers = Table() numbers.add_column('number', data=[      1,      2,       3,       4,   None]) numbers.add_column('colour', data=['black', 'blue', 'white', 'white', 'blue'])  letters = Table() letters.add_column('letter', data=[  'a',     'b',      'c',     'd',   None]) letters.add_column('color', data=['blue', 'white', 'orange', 'white', 'blue'])  In\u00a0[49]: Copied! <pre>## left join\n## SELECT number, letter FROM numbers LEFT JOIN letters ON numbers.colour == letters.color\nleft_join = numbers.left_join(letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter'])\nleft_join\n</pre> ## left join ## SELECT number, letter FROM numbers LEFT JOIN letters ON numbers.colour == letters.color left_join = numbers.left_join(letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter']) left_join <pre>join: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 2/2 [00:00&lt;00:00, 1221.94it/s]\n</pre> Out[49]: #numberletter 01None 12a 22None 3Nonea 4NoneNone 53b 63d 74b 84d In\u00a0[50]: Copied! <pre>## inner join\n## SELECT number, letter FROM numbers JOIN letters ON numbers.colour == letters.color\ninner_join = numbers.inner_join(letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter'])\ninner_join\n</pre> ## inner join ## SELECT number, letter FROM numbers JOIN letters ON numbers.colour == letters.color inner_join = numbers.inner_join(letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter']) inner_join <pre>join: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 2/2 [00:00&lt;00:00, 1121.77it/s]\n</pre> Out[50]: #numberletter 02a 12None 2Nonea 3NoneNone 43b 53d 64b 74d In\u00a0[51]: Copied! <pre># outer join\n## SELECT number, letter FROM numbers OUTER JOIN letters ON numbers.colour == letters.color\nouter_join = numbers.outer_join(letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter'])\nouter_join\n</pre>  # outer join ## SELECT number, letter FROM numbers OUTER JOIN letters ON numbers.colour == letters.color outer_join = numbers.outer_join(letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter']) outer_join <pre>join: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 2/2 [00:00&lt;00:00, 1585.15it/s]\n</pre> Out[51]: #numberletter 01None 12a 22None 3Nonea 4NoneNone 53b 63d 74b 84d 9Nonec <p>Q: But ...I think there's a bug in the join... A: Venn diagrams do not explain joins.</p> <p>A Venn diagram is a widely-used diagram style that shows the logical relation between sets, popularised by John Venn in the 1880s. The diagrams are used to teach elementary set theory, and to illustrate simple set relationshipssource: en.wikipedia.org</p> <p>Joins operate over rows and when there are duplicate rows, these will be replicated in the output. Many beginners are surprised by this, because they didn't read the SQL standard.</p> <p>Q: So what do I do? A: If you want to get rid of duplicates using tablite, use the <code>index</code> functionality across all columns and pick the first row from each index. Here's the recipe that starts with plenty of duplicates:</p> In\u00a0[52]: Copied! <pre>old_table = Table({\n'A':[1,1,1,2,2,2,3,3,3],\n'B':[1,1,4,2,2,5,3,3,6],\n})\nold_table\n</pre> old_table = Table({ 'A':[1,1,1,2,2,2,3,3,3], 'B':[1,1,4,2,2,5,3,3,6], }) old_table Out[52]: #AB 011 111 214 322 422 525 633 733 836 In\u00a0[53]: Copied! <pre>## CREATE TABLE OF UNIQUE ENTRIES (a.k.a. DEDUPLICATE)\nnew_table = old_table.drop_duplicates()\nnew_table\n</pre> ## CREATE TABLE OF UNIQUE ENTRIES (a.k.a. DEDUPLICATE) new_table = old_table.drop_duplicates() new_table <pre>9it [00:00, 11329.15it/s]\njoin: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 2/2 [00:00&lt;00:00, 1819.26it/s]\n</pre> Out[53]: #AB 011 114 222 325 433 536 <p>You can also use groupby; We'll get to that in a minute.</p> <p>Lookup is a special case of a search loop: Say for example you are planning a concert and want to make sure that your friends can make it home using public transport: You would have to find the first departure after the concert ends towards their home. A join would only give you a direct match on the time.</p> <p>Lookup allows you \"to iterate through a list of data and find the first match given a set of criteria.\"</p> <p>Here's an example:</p> <p>First we have our list of friends and their stops.</p> In\u00a0[54]: Copied! <pre>friends = Table({\n\"name\":['Alice', 'Betty', 'Charlie', 'Dorethy', 'Edward', 'Fred'],\n\"stop\":['Downtown-1', 'Downtown-2', 'Hillside View', 'Hillside Crescent', 'Downtown-2', 'Chicago'],\n})\nfriends\n</pre> friends = Table({ \"name\":['Alice', 'Betty', 'Charlie', 'Dorethy', 'Edward', 'Fred'], \"stop\":['Downtown-1', 'Downtown-2', 'Hillside View', 'Hillside Crescent', 'Downtown-2', 'Chicago'], }) friends Out[54]: #namestop 0AliceDowntown-1 1BettyDowntown-2 2CharlieHillside View 3DorethyHillside Crescent 4EdwardDowntown-2 5FredChicago <p>Next we need a list of bus routes and their time and stops. I don't have that, so I'm making one up:</p> In\u00a0[55]: Copied! <pre>import random\nrandom.seed(11)\ntable_size = 40\n\ntimes = [DataTypes.time(random.randint(21, 23), random.randint(0, 59)) for i in range(table_size)]\nstops = ['Stadium', 'Hillside', 'Hillside View', 'Hillside Crescent', 'Downtown-1', 'Downtown-2',\n            'Central station'] * 2 + [f'Random Road-{i}' for i in range(table_size)]\nroute = [random.choice([1, 2, 3]) for i in stops]\n</pre>  import random random.seed(11) table_size = 40  times = [DataTypes.time(random.randint(21, 23), random.randint(0, 59)) for i in range(table_size)] stops = ['Stadium', 'Hillside', 'Hillside View', 'Hillside Crescent', 'Downtown-1', 'Downtown-2',             'Central station'] * 2 + [f'Random Road-{i}' for i in range(table_size)] route = [random.choice([1, 2, 3]) for i in stops]  In\u00a0[56]: Copied! <pre>bus_table = Table({\n\"time\":times,\n\"stop\":stops[:table_size],\n\"route\":route[:table_size],\n})\nbus_table.sort(mapping={'time': False})\n\nprint(\"Departures from Concert Hall towards ...\")\nbus_table[0:10]\n</pre>  bus_table = Table({ \"time\":times, \"stop\":stops[:table_size], \"route\":route[:table_size], }) bus_table.sort(mapping={'time': False})  print(\"Departures from Concert Hall towards ...\") bus_table[0:10]  <pre>creating sort index: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 1/1 [00:00&lt;00:00, 1459.90it/s]\njoin: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 3/3 [00:00&lt;00:00, 2421.65it/s]\n</pre> <pre>Departures from Concert Hall towards ...\n</pre> Out[56]: #timestoproute 021:02:00Random Road-62 121:05:00Hillside Crescent2 221:06:00Hillside1 321:25:00Random Road-241 421:29:00Random Road-161 521:32:00Random Road-211 621:33:00Random Road-121 721:36:00Random Road-233 821:38:00Central station2 921:38:00Random Road-82 <p>Let's say the concerts ends at 21:00 and it takes a 10 minutes to get to the bus-stop. Earliest departure must then be 21:10 - goodbye hugs included.</p> In\u00a0[57]: Copied! <pre>lookup_1 = friends.lookup(bus_table, (DataTypes.time(21, 10), \"&lt;=\", 'time'), ('stop', \"==\", 'stop'))\nlookup1_sorted = lookup_1.sorted(mapping={'time': False, 'name':False}, sort_mode='unix')\nlookup1_sorted\n</pre> lookup_1 = friends.lookup(bus_table, (DataTypes.time(21, 10), \"&lt;=\", 'time'), ('stop', \"==\", 'stop')) lookup1_sorted = lookup_1.sorted(mapping={'time': False, 'name':False}, sort_mode='unix') lookup1_sorted <pre>100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 6/6 [00:00&lt;00:00, 1513.92it/s]\njoin: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 3/3 [00:00&lt;00:00, 2003.65it/s]\ncreating sort index: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 2/2 [00:00&lt;00:00, 2589.88it/s]\njoin: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 5/5 [00:00&lt;00:00, 2034.29it/s]\n</pre> Out[57]: #namestoptimestop_1route 0FredChicagoNoneNoneNone 1BettyDowntown-221:51:00Downtown-21 2EdwardDowntown-221:51:00Downtown-21 3CharlieHillside View22:19:00Hillside View2 4AliceDowntown-123:12:00Downtown-13 5DorethyHillside Crescent23:54:00Hillside Crescent1 <p>Lookup's ability to custom criteria is thereby far more versatile than SQL joins.</p> <p>But with great power comes great responsibility.</p> In\u00a0[58]: Copied! <pre>materials = Table({\n    'bom_id': [1, 2, 3, 4, 5, 6, 7, 8, 9], \n    'partial_of': [1, 2, 3, 4, 5, 6, 7, 4, 6], \n    'sku': ['A', 'irrelevant', 'empty carton', 'pkd carton', 'empty pallet', 'pkd pallet', 'pkd irrelevant', 'ppkd carton', 'ppkd pallet'], \n    'material_id': [None, None, None, 3, None, 5, 3, 3, 5], \n    'quantity': [10, 20, 30, 40, 50, 60, 70, 80, 90]\n})\n    # 9 is a partially packed pallet of 6\n\n## multiple values.\nlooking_for = Table({\n    'bom_id': [3,4,6], \n    'moq': [1,2,3]\n    })\n</pre> materials = Table({     'bom_id': [1, 2, 3, 4, 5, 6, 7, 8, 9],      'partial_of': [1, 2, 3, 4, 5, 6, 7, 4, 6],      'sku': ['A', 'irrelevant', 'empty carton', 'pkd carton', 'empty pallet', 'pkd pallet', 'pkd irrelevant', 'ppkd carton', 'ppkd pallet'],      'material_id': [None, None, None, 3, None, 5, 3, 3, 5],      'quantity': [10, 20, 30, 40, 50, 60, 70, 80, 90] })     # 9 is a partially packed pallet of 6  ## multiple values. looking_for = Table({     'bom_id': [3,4,6],      'moq': [1,2,3]     })  <p>Our goals is now to find the quantity from the <code>materials</code> table based on the items in the <code>looking_for</code> table.</p> <p>This requires two steps:</p> <ol> <li>lookup</li> <li>filter for <code>all</code> by dropping items that didn't match.</li> </ol> In\u00a0[59]: Copied! <pre>## step 1/2:\nproducts_lookup = materials.lookup(looking_for, (\"bom_id\", \"==\", \"bom_id\"), (\"partial_of\", \"==\", \"bom_id\"), all=False)   \nproducts_lookup\n</pre> ## step 1/2: products_lookup = materials.lookup(looking_for, (\"bom_id\", \"==\", \"bom_id\"), (\"partial_of\", \"==\", \"bom_id\"), all=False)    products_lookup <pre>100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 9/9 [00:00&lt;00:00, 3651.81it/s]\njoin: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 2/2 [00:00&lt;00:00, 1625.38it/s]\n</pre> Out[59]: #bom_idpartial_ofskumaterial_idquantitybom_id_1moq 011ANone10NoneNone 122irrelevantNone20NoneNone 233empty cartonNone3031 344pkd carton34042 455empty palletNone50NoneNone 566pkd pallet56063 677pkd irrelevant370NoneNone 784ppkd carton38042 896ppkd pallet59063 In\u00a0[60]: Copied! <pre>## step 2/2:\nproducts = products_lookup.all(bom_id_1=lambda x: x is not None)\nproducts\n</pre> ## step 2/2: products = products_lookup.all(bom_id_1=lambda x: x is not None) products Out[60]: #bom_idpartial_ofskumaterial_idquantitybom_id_1moq 033empty cartonNone3031 144pkd carton34042 266pkd pallet56063 384ppkd carton38042 496ppkd pallet59063 <p>The faster way to solve this problem is to use <code>match</code>!</p> <p>Here is the example:</p> In\u00a0[61]: Copied! <pre>products_matched = materials.match(looking_for, (\"bom_id\", \"==\", \"bom_id\"), (\"partial_of\", \"==\", \"bom_id\"))\nproducts_matched\n</pre> products_matched = materials.match(looking_for, (\"bom_id\", \"==\", \"bom_id\"), (\"partial_of\", \"==\", \"bom_id\")) products_matched Out[61]: #bom_idpartial_ofskumaterial_idquantitybom_id_1moq 033empty cartonNone3031 144pkd carton34042 266pkd pallet56063 384ppkd carton38042 496ppkd pallet59063 In\u00a0[62]: Copied! <pre>assert products == products_matched\n</pre> assert products == products_matched In\u00a0[63]: Copied! <pre>from tablite import Table\nt = Table()  # create table\nt.add_columns('row','A','B','C')  # add columns\n</pre> from tablite import Table t = Table()  # create table t.add_columns('row','A','B','C')  # add columns <p>The following examples are all valid and append the row (1,2,3) to the table.</p> In\u00a0[64]: Copied! <pre>t.add_rows(1, 1, 2, 3)  # individual values\nt.add_rows([2, 1, 2, 3])  # list of values\nt.add_rows((3, 1, 2, 3))  # tuple of values\nt.add_rows(*(4, 1, 2, 3))  # unpacked tuple\nt.add_rows(row=5, A=1, B=2, C=3)   # keyword - args\nt.add_rows(**{'row': 6, 'A': 1, 'B': 2, 'C': 3})  # dict / json.\n</pre> t.add_rows(1, 1, 2, 3)  # individual values t.add_rows([2, 1, 2, 3])  # list of values t.add_rows((3, 1, 2, 3))  # tuple of values t.add_rows(*(4, 1, 2, 3))  # unpacked tuple t.add_rows(row=5, A=1, B=2, C=3)   # keyword - args t.add_rows(**{'row': 6, 'A': 1, 'B': 2, 'C': 3})  # dict / json. <p>The following examples add two rows to the table</p> In\u00a0[65]: Copied! <pre>t.add_rows((7, 1, 2, 3), (8, 4, 5, 6))  # two (or more) tuples.\nt.add_rows([9, 1, 2, 3], [10, 4, 5, 6])  # two or more lists\nt.add_rows({'row': 11, 'A': 1, 'B': 2, 'C': 3},\n          {'row': 12, 'A': 4, 'B': 5, 'C': 6})  # two (or more) dicts as args.\nt.add_rows(*[{'row': 13, 'A': 1, 'B': 2, 'C': 3},\n            {'row': 14, 'A': 1, 'B': 2, 'C': 3}])  # list of dicts.\n</pre> t.add_rows((7, 1, 2, 3), (8, 4, 5, 6))  # two (or more) tuples. t.add_rows([9, 1, 2, 3], [10, 4, 5, 6])  # two or more lists t.add_rows({'row': 11, 'A': 1, 'B': 2, 'C': 3},           {'row': 12, 'A': 4, 'B': 5, 'C': 6})  # two (or more) dicts as args. t.add_rows(*[{'row': 13, 'A': 1, 'B': 2, 'C': 3},             {'row': 14, 'A': 1, 'B': 2, 'C': 3}])  # list of dicts. In\u00a0[66]: Copied! <pre>t\n</pre> t Out[66]: #rowABC 01123 12123 23123 34123 45123 56123 67123 78456 89123 9104561011123111245612131231314123 <p>As the row incremented from <code>1</code> in the first of these examples, and finished with <code>row: 14</code>, you can now see the whole table above</p> In\u00a0[67]: Copied! <pre>from pathlib import Path\npath = Path('tests/data/book1.csv')\ntx = Table.from_file(path)\ntx\n</pre> from pathlib import Path path = Path('tests/data/book1.csv') tx = Table.from_file(path) tx  <pre>Collecting tasks: 'tests/data/book1.csv'\nDumping tasks: 'tests/data/book1.csv'\n</pre> <pre>importing file: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 1/1 [00:00&lt;00:00, 444.08it/s]\n</pre> Out[67]: #abcdef 010.0606060610.0909090910.1212121210.1515151520.181818182 120.1212121210.2424242420.4848484850.969696971.939393939 230.2424242420.4848484850.969696971.9393939393.878787879 340.4848484850.969696971.9393939393.8787878797.757575758 450.969696971.9393939393.8787878797.75757575815.51515152 561.9393939393.8787878797.75757575815.5151515231.03030303 673.8787878797.75757575815.5151515231.0303030362.06060606.....................383916659267088.033318534175.066637068350.0133274000000.0266548000000.0394033318534175.066637068350.0133274000000.0266548000000.0533097000000.0404166637068350.0133274000000.0266548000000.0533097000000.01066190000000.04142133274000000.0266548000000.0533097000000.01066190000000.02132390000000.04243266548000000.0533097000000.01066190000000.02132390000000.04264770000000.04344533097000000.01066190000000.02132390000000.04264770000000.08529540000000.044451066190000000.02132390000000.04264770000000.08529540000000.017059100000000.0 <p>Note that you can also add start, limit and chunk_size to the file reader. Here's an example:</p> In\u00a0[68]: Copied! <pre>path = Path('tests/data/book1.csv')\ntx2 = Table.from_file(path, start=2, limit=15)\ntx2\n</pre> path = Path('tests/data/book1.csv') tx2 = Table.from_file(path, start=2, limit=15) tx2 <pre>Collecting tasks: 'tests/data/book1.csv'\n</pre> <pre>importing file: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 1/1 [00:00&lt;00:00, 391.22it/s]</pre> <pre>Dumping tasks: 'tests/data/book1.csv'\n</pre> <pre>\n</pre> Out[68]: #abcdef 030.2424242420.4848484850.969696971.9393939393.878787879 140.4848484850.969696971.9393939393.8787878797.757575758 250.969696971.9393939393.8787878797.75757575815.51515152 361.9393939393.8787878797.75757575815.5151515231.03030303 473.8787878797.75757575815.5151515231.0303030362.06060606 587.75757575815.5151515231.0303030362.06060606124.1212121 6915.5151515231.0303030362.06060606124.1212121248.2424242 71031.0303030362.06060606124.1212121248.2424242496.4848485 81162.06060606124.1212121248.2424242496.4848485992.969697 912124.1212121248.2424242496.4848485992.9696971985.9393941013248.2424242496.4848485992.9696971985.9393943971.8787881114496.4848485992.9696971985.9393943971.8787887943.7575761215992.9696971985.9393943971.8787887943.75757615887.5151513161985.9393943971.8787887943.75757615887.5151531775.030314173971.8787887943.75757615887.5151531775.030363550.06061 <p>How good is the file_reader?</p> <p>I've included all formats in the test suite that are publicly available from the Alan Turing institute, dateutils) and Python's csv reader.</p> <p>What about <code>MM-DD-YYYY</code> formats? Some users from the US ask why the csv reader doesn't read the month-day-year format.</p> <p>The answer is simple: It's not an iso8601 format. The US month-day-year format is a locale that may be used a lot in the US, but it isn't an international standard.</p> <p>If you need to work with <code>MM-DD-YYYY</code> you will find that the file_reader will import the values as text (str). You can then reformat it with a custom function like:</p> In\u00a0[69]: Copied! <pre>s = \"03-21-1998\"\nfrom datetime import date\nf = lambda s: date(int(s[-4:]), int(s[:2]), int(s[3:5]))\nf(s)\n</pre> s = \"03-21-1998\" from datetime import date f = lambda s: date(int(s[-4:]), int(s[:2]), int(s[3:5])) f(s) Out[69]: <pre>datetime.date(1998, 3, 21)</pre> In\u00a0[70]: Copied! <pre>from tablite.import_utils import file_readers\nfor k,v in file_readers.items():\n    print(k,v)\n</pre> from tablite.import_utils import file_readers for k,v in file_readers.items():     print(k,v) <pre>fods &lt;function excel_reader at 0x7f36a3ef8c10&gt;\njson &lt;function excel_reader at 0x7f36a3ef8c10&gt;\nhtml &lt;function from_html at 0x7f36a3ef8b80&gt;\nhdf5 &lt;function from_hdf5 at 0x7f36a3ef8a60&gt;\nsimple &lt;function excel_reader at 0x7f36a3ef8c10&gt;\nrst &lt;function excel_reader at 0x7f36a3ef8c10&gt;\nmediawiki &lt;function excel_reader at 0x7f36a3ef8c10&gt;\nxlsx &lt;function excel_reader at 0x7f36a3ef8c10&gt;\nxls &lt;function excel_reader at 0x7f36a3ef8c10&gt;\nxlsm &lt;function excel_reader at 0x7f36a3ef8c10&gt;\ncsv &lt;function text_reader at 0x7f36a3ef9000&gt;\ntsv &lt;function text_reader at 0x7f36a3ef9000&gt;\ntxt &lt;function text_reader at 0x7f36a3ef9000&gt;\nods &lt;function ods_reader at 0x7f36a3ef8ca0&gt;\n</pre> <p>(2) define your new file reader</p> In\u00a0[71]: Copied! <pre>def my_magic_reader(path, **kwargs):   # define your new file reader.\n    print(\"do magic with {path}\")\n    return\n</pre> def my_magic_reader(path, **kwargs):   # define your new file reader.     print(\"do magic with {path}\")     return <p>(3) add it to the list of readers.</p> In\u00a0[72]: Copied! <pre>file_readers['my_special_format'] = my_magic_reader\n</pre> file_readers['my_special_format'] = my_magic_reader <p>The <code>file_readers</code> are all in tablite.core so if you intend to extend the readers, I recommend that you start here.</p> In\u00a0[73]: Copied! <pre>file = Path('example.xlsx')\ntx2.to_xlsx(file)\nos.remove(file)\n</pre> file = Path('example.xlsx') tx2.to_xlsx(file) os.remove(file) <p></p> In\u00a0[74]: Copied! <pre>from tablite import Table\n\nt = Table({\n'a':[1, 2, 8, 3, 4, 6, 5, 7, 9],\n'b':[10, 100, 3, 4, 16, -1, 10, 10, 10],\n})\nt.sort(mapping={\"a\":False})\nt\n</pre> from tablite import Table  t = Table({ 'a':[1, 2, 8, 3, 4, 6, 5, 7, 9], 'b':[10, 100, 3, 4, 16, -1, 10, 10, 10], }) t.sort(mapping={\"a\":False}) t <pre>creating sort index: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 1/1 [00:00&lt;00:00, 1674.37it/s]\njoin: 100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 2/2 [00:00&lt;00:00, 1701.89it/s]\n</pre> Out[74]: #ab 0110 12100 234 3416 4510 56-1 6710 783 8910 In\u00a0[75]: Copied! <pre>%pip install matplotlib -q\n</pre> %pip install matplotlib -q <pre>Note: you may need to restart the kernel to use updated packages.\n</pre> In\u00a0[76]: Copied! <pre>import matplotlib.pyplot as plt\nplt.plot(t['a'], t['b'])\nplt.ylabel('Hello Figure')\nplt.show()\n</pre> import matplotlib.pyplot as plt plt.plot(t['a'], t['b']) plt.ylabel('Hello Figure') plt.show() In\u00a0[77]: Copied! <pre>## Let's monitor the memory and record the observations into a table!\nimport psutil, os, gc\nfrom time import process_time,sleep\nprocess = psutil.Process(os.getpid())\n\ndef mem_time():  # go and check taskmanagers memory usage.\n    return process.memory_info().rss, process_time()\n\ndigits = 1_000_000\n\nrecords = Table({'method':[], 'memory':[], 'time':[]})\n</pre> ## Let's monitor the memory and record the observations into a table! import psutil, os, gc from time import process_time,sleep process = psutil.Process(os.getpid())  def mem_time():  # go and check taskmanagers memory usage.     return process.memory_info().rss, process_time()  digits = 1_000_000  records = Table({'method':[], 'memory':[], 'time':[]})  <p>The row based format: 1 million 10-tuples</p> In\u00a0[78]: Copied! <pre>before, start = mem_time()\nL = [tuple([11 for _ in range(10)]) for _ in range(digits)]\nafter, end = mem_time()  \ndel L\ngc.collect()\n\nrecords.add_rows(*('1e6 lists w. 10 integers', after - before, round(end-start,4)))\nrecords\n</pre> before, start = mem_time() L = [tuple([11 for _ in range(10)]) for _ in range(digits)] after, end = mem_time()   del L gc.collect()  records.add_rows(*('1e6 lists w. 10 integers', after - before, round(end-start,4))) records Out[78]: #methodmemorytime 01e6 lists w. 10 integers1190543360.5045 <p>The column based format: 10 columns with 1M values:</p> In\u00a0[79]: Copied! <pre>before, start = mem_time()\nL = [[11 for i2 in range(digits)] for i1 in range(10)]\nafter,end = mem_time()\n\ndel L\ngc.collect()\nrecords.add_rows(('10 lists with 1e6 integers', after - before, round(end-start,4)))\n</pre> before, start = mem_time() L = [[11 for i2 in range(digits)] for i1 in range(10)] after,end = mem_time()  del L gc.collect() records.add_rows(('10 lists with 1e6 integers', after - before, round(end-start,4))) <p>We've thereby saved 50 Mb by avoiding the overhead from managing 1 million lists.</p> <p>Q: But why didn't I just use an array? It would have even lower memory footprint.</p> <p>A: First, array's don't handle None's and we get that frequently in dirty csv data.</p> <p>Second, Table needs even less memory.</p> <p>Let's try with an array:</p> In\u00a0[80]: Copied! <pre>import array\n\nbefore, start = mem_time()\nL = [array.array('i', [11 for _ in range(digits)]) for _ in range(10)]\nafter,end = mem_time()\n\ndel L\ngc.collect()\nrecords.add_rows(('10 lists with 1e6 integers in arrays', after - before, round(end-start,4)))\nrecords\n</pre> import array  before, start = mem_time() L = [array.array('i', [11 for _ in range(digits)]) for _ in range(10)] after,end = mem_time()  del L gc.collect() records.add_rows(('10 lists with 1e6 integers in arrays', after - before, round(end-start,4))) records Out[80]: #methodmemorytime 01e6 lists w. 10 integers1190543360.5045 110 lists with 1e6 integers752762880.1906 210 lists with 1e6 integers in arrays398336000.3633 <p>Finally let's use a <code>tablite.Table</code>:</p> In\u00a0[81]: Copied! <pre>before,start = mem_time()\nt = Table(columns={str(i1): [11 for i2 in range(digits)] for i1 in range(10)})\nafter,end = mem_time()\n\nrecords.add_rows(('Table with 10 columns with 1e6 integers', after - before, round(end-start,4)))\n\nbefore,start = mem_time()\nt2 = t.copy()\nafter,end = mem_time()\n\nrecords.add_rows(('2 Tables with 10 columns with 1e6 integers each', after - before, round(end-start,4)))\n\n## Let's show it, so we know nobody's cheating:\nt2\n</pre> before,start = mem_time() t = Table(columns={str(i1): [11 for i2 in range(digits)] for i1 in range(10)}) after,end = mem_time()  records.add_rows(('Table with 10 columns with 1e6 integers', after - before, round(end-start,4)))  before,start = mem_time() t2 = t.copy() after,end = mem_time()  records.add_rows(('2 Tables with 10 columns with 1e6 integers each', after - before, round(end-start,4)))  ## Let's show it, so we know nobody's cheating: t2  Out[81]: #0123456789        011111111111111111111        111111111111111111111        211111111111111111111        311111111111111111111        411111111111111111111        511111111111111111111        611111111111111111111.................................  999,99311111111111111111111  999,99411111111111111111111  999,99511111111111111111111  999,99611111111111111111111  999,99711111111111111111111  999,99811111111111111111111  999,99911111111111111111111 In\u00a0[82]: Copied! <pre>records\n</pre> records Out[82]: #methodmemorytime 01e6 lists w. 10 integers1190543360.5045 110 lists with 1e6 integers752762880.1906 210 lists with 1e6 integers in arrays398336000.3633 3Table with 10 columns with 1e6 integers01.9569 42 Tables with 10 columns with 1e6 integers each00.0001 <p>Conclusion: whilst the common worst case (1M lists with 10 integers) take up 118 Mb of RAM, Tablite's tables vanish in the noise of memory measurement.</p> <p>Pandas also permits the usage of namedtuples, which are unpacked upon entry.</p> <pre>from collections import namedtuple\nPoint = namedtuple(\"Point\", \"x y\")\npoints = [Point(0, 0), Point(0, 3)]\npd.DataFrame(points)\n</pre> <p>Doing that in tablite is a bit different. To unpack the named tuple, you should do so explicitly:</p> <pre>t = Table({'x': [p.x for p in points], 'y': [p.y for p in points]})\n</pre> <p>However should you want to keep the points as namedtuple, you can do so in tablite:</p> <pre>t = Table()\nt['points'] = points\n</pre> <p>Tablite will store a serialised version of the points, so your memory overhead will be close to zero.</p>"},{"location":"tutorial/#tablite","title":"Tablite\u00b6","text":""},{"location":"tutorial/#introduction","title":"Introduction\u00b6","text":"<p>Tablite fills the data-science space where incremental data processing based on:</p> <ul> <li>Datasets are larger than memory.</li> <li>You don't want to worry about datatypes.</li> </ul> <p>Tablite thereby competes with:</p> <ul> <li>Pandas, but saves the memory overhead.</li> <li>Numpy, but spares you from worrying about lower level data types</li> <li>SQlite, by sheer speed.</li> <li>Polars, by working beyond RAM.</li> <li>Other libraries for data cleaning thanks to tablites powerful <code>datatypes</code> module.</li> </ul> <p>Install: <code>pip install tablite</code></p> <p>Usage:  <code>&gt;&gt;&gt; from tablite import Table</code></p> <p>Upgrade: <code>pip install tablite --no-cache --upgrade</code></p>"},{"location":"tutorial/#overview","title":"Overview\u00b6","text":"<p>(Version 2023.6.0 and later. For older version see this)</p> <ul> <li>Tablite handles all Python datatypes: <code>str</code>, <code>float</code>, <code>bool</code>, <code>int</code>, <code>date</code>, <code>datetime</code>, <code>time</code>, <code>timedelta</code> and <code>None</code>.</li> <li>you can select:<ul> <li>all rows in a column as <code>table['A']</code></li> <li>rows across all columns as <code>table[4:8]</code></li> <li>or a slice as <code>table['A', 'B', slice(4,8) ]</code>.</li> </ul> </li> <li>you to update with <code>table['A'][2] = new value</code></li> <li>you can store or send data using json, by:<ul> <li>dumping to json: <code>json_str = table.to_json()</code>, or</li> <li>you can load it with <code>Table.from_json(json_str)</code>.</li> </ul> </li> <li>you can iterate over rows using <code>for row in Table.rows</code>.</li> <li>you can ask <code>column_xyz in Table.colums</code> ?</li> <li>load from files with <code>new_table = Table.from_file('this.csv')</code> which has automatic datatype detection</li> <li>perform inner, outer &amp; left sql join between tables as simple as <code>table_1.inner_join(table2, keys=['A', 'B'])</code></li> <li>summarise using <code>table.groupby( ... )</code></li> <li>create pivot tables using <code>groupby.pivot( ... )</code></li> <li>perform multi-criteria lookup in tables using <code>table1.lookup(table2, criteria=.....</code></li> <li>and of course a large selection of tools in <code>from tablite.tools import *</code></li> </ul>"},{"location":"tutorial/#examples","title":"Examples\u00b6","text":"<p>Here are some examples:</p>"},{"location":"tutorial/#api-examples","title":"API Examples\u00b6","text":"<p>In the following sections, example are given of the Tablite API's power features:</p> <ul> <li>Iteration</li> <li>Append</li> <li>Sort</li> <li>Filter</li> <li>Index</li> <li>Search All</li> <li>Search Any</li> <li>Lookup</li> <li>Join inner, outer,</li> <li>GroupBy</li> <li>Pivot table</li> </ul>"},{"location":"tutorial/#iteration","title":"ITERATION!\u00b6","text":"<p>Iteration supports for loops and list comprehension at the speed of light:</p> <p>Just use <code>[r for r in table.rows]</code>, or:</p> <pre><code>for row in table.rows:\n    row ...</code></pre> <p>Here's a more practical use case:</p> <p>(1) Imagine a table with columns a,b,c,d,e (all integers) like this:</p>"},{"location":"tutorial/#create-index-indices","title":"Create Index / Indices\u00b6","text":"<p>Index supports multi-key indexing using args such as: <code>index = table.index('B','C')</code>.</p> <p>Here's an example:</p>"},{"location":"tutorial/#append","title":"APPEND\u00b6","text":""},{"location":"tutorial/#save","title":"SAVE\u00b6","text":""},{"location":"tutorial/#filter","title":"FILTER!\u00b6","text":""},{"location":"tutorial/#any-all","title":"Any! All?\u00b6","text":"<p>Any and All are cousins of the filter. They're there so you can use them in the same way as you'd use <code>any</code> and <code>all</code> in python - as boolean evaluators:</p>"},{"location":"tutorial/#sort","title":"SORT!\u00b6","text":""},{"location":"tutorial/#groupby","title":"GROUPBY !\u00b6","text":""},{"location":"tutorial/#did-i-say-pivot-table-yes","title":"Did I say pivot table? Yes.\u00b6","text":"<p>Pivot Table is included in the groupby functionality - so yes - you can pivot the groupby on any column that is used for grouping. Here's a simple example:</p>"},{"location":"tutorial/#join","title":"JOIN!\u00b6","text":""},{"location":"tutorial/#lookup","title":"LOOKUP!\u00b6","text":""},{"location":"tutorial/#match","title":"Match\u00b6","text":"<p>If you're looking to do a join where you afterwards remove the empty rows, <code>match</code> is the faster choice.</p> <p>Here is an example.</p> <p>Let's start with two tables:</p>"},{"location":"tutorial/#are-there-other-ways-i-can-add-data","title":"Are there other ways I can add data?\u00b6","text":"<p>Yes - but row based operations cause a lot of IO, so it'll work but be slower:</p>"},{"location":"tutorial/#okay-great-how-do-i-load-data","title":"Okay, great. How do I load data?\u00b6","text":"<p>Easy. Use <code>file_reader</code>. Here's an example:</p>"},{"location":"tutorial/#sweet-what-formats-are-supported-can-i-add-my-own-file-reader","title":"Sweet. What formats are supported? Can I add my own file reader?\u00b6","text":"<p>Yes! This is very good for special log files or custom json formats. Here's how you do it:</p> <p>(1) Go to all existing readers in the <code>tablite.core</code> and find the closest match.</p>"},{"location":"tutorial/#very-nice-how-about-exporting-data","title":"Very nice. How about exporting data?\u00b6","text":"<p>Just use .export</p>"},{"location":"tutorial/#cool-does-it-play-well-with-plotting-packages","title":"Cool. Does it play well with plotting packages?\u00b6","text":"<p>Yes. Here's an example you can copy and paste:</p>"},{"location":"tutorial/#i-like-sql-can-tablite-understand-sql","title":"I like sql. Can tablite understand SQL?\u00b6","text":"<p>Almost. You can use <code>table.to_sql</code> and tablite will return ANSI-92 compliant SQL.</p> <p>You can also create a table using <code>Table.from_sql</code> and tablite will consume ANSI-92 compliant SQL.</p>"},{"location":"tutorial/#but-what-do-i-do-if-im-about-to-run-out-of-memory","title":"But what do I do if I'm about to run out of memory?\u00b6","text":"<p>You wont. Every tablite table is backed by disk. The memory footprint of a table is only the metadata required to know the relationships between variable names and the datastructures.</p> <p>Let's do a comparison:</p>"},{"location":"tutorial/#conclusions","title":"Conclusions\u00b6","text":"<p>This concludes the mega-tutorial to <code>tablite</code>. There's nothing more to it. But oh boy it'll save a lot of time.</p> <p>Here's a summary of features:</p> <ul> <li>Everything a list can do.</li> <li>import csv*, fods, json, html, simple, rst, mediawiki, xlsx, xls, xlsm, csv, tsv, txt, ods using <code>Table.from_file(...)</code></li> <li>Iterate over rows or columns</li> <li>Create multikey <code>index</code>, <code>sort</code>, use <code>filter</code>, <code>any</code> and <code>all</code> to select. Perform <code>lookup</code> across tables including using custom functions.</li> <li>Perform multikey <code>joins</code> with other tables.</li> <li>Perform <code>groupby</code> and reorganise data as a <code>pivot</code> table with max, min, sum, first, last, count, unique, average, standard deviation, median and mode.</li> <li>Update tables with <code>+=</code> which automatically sorts out the columns - even if they're not in perfect order.</li> </ul>"},{"location":"tutorial/#faq","title":"FAQ\u00b6","text":"Question Answer I'm not in a notebook. Is there a nice way to view tables? Yes. <code>table.show()</code> prints the ascii version I'm looking for the equivalent to <code>apply</code> in pandas. Just use list comprehensions: <code>table[column] = [f(x) for x in table[column]</code> What about <code>map</code>? Just use the python function: <code>mapping = map(f, table[column name])</code> Is there a <code>where</code> function? It's called <code>any</code> or <code>all</code> like in python: <code>table.any(column_name &gt; 0)</code>. I like sql and sqlite. Can I use sql? Yes. Call <code>table.to_sql()</code> returns ANSI-92 SQL compliant table definition.You can use this in any SQL compliant engine. <p>| sometimes i need to clean up data with datetimes. Is there any tool to help with that? | Yes. Look at DataTypes.<code>DataTypes.round(value, multiple)</code> allows rounding of datetime.</p>"},{"location":"tutorial/#coming-to-tablite-from-pandas","title":"Coming to Tablite from Pandas\u00b6","text":"<p>If you're coming to Tablite from Pandas you will notice some differences.</p> <p>Here's the ultra short comparison to the documentation from Pandas called 10 minutes intro to pandas</p> <p>The tutorials provide the generic overview:</p> <ul> <li>pandas tutorial</li> <li>tablite tutorial</li> </ul> <p>Some key differences</p> topic Tablite Viewing data Just use <code>table.show()</code> in print outs, or if you're in a jupyter notebook just use the variable name <code>table</code> Selection Slicing works both on columns and rows, and you can filter using <code>any</code> or <code>all</code>:<code>table['A','B', 2:30:3].any(A=lambda x:x&gt;3)</code> to copy a table use: <code>t2 = t.copy()</code>This is a very fast deep copy, that has no memory overhead as tablites memory manager keeps track of the data. Missing data Tablite uses <code>mixed</code> column format for any format that isn't uniformTo get rid of rows with <code>None</code>s and <code>np.nan</code>s use any:<code>table.drop_na(None, np.nan)</code> Alternatively you can use replace: <code>table.replace(None,5)</code> following the syntax: <code>table.replace_missing_values(sources, target)</code> Operations Descriptive statistics are on a colum by column basis:<code>table['a'].statistics()</code>  the pandas function <code>df.apply</code> doesn't exist in tablite. Use a list comprehension instead. For example: <code>df.apply(np.cumsum)</code> is just <code>np.cumsum(t['A'])</code>  \"histogramming\" in tablite is per column: <code>table['a'].histogram()</code>  string methods? Just use a list comprehensions: <code>table['A', 'B'].any(A=lambda x: \"hello\" in x, B=lambda x: \"world\" in x)</code> Merge Concatenation: Just use <code>+</code> or <code>+=</code> as in <code>t1 = t2 + t3 += t4</code>. If the columns are out of order, tablite will sort the headers according to the order in the first table.If you're worried that the header mismatch use <code>t1.stack(t2)</code>  Joins are ANSI92 compliant: <code>t1.join(t2, &lt;...args...&gt;, join_type=...)</code>. Grouping Tablite supports multikey groupby using <code>from tablite import Groupby as gb</code>. <code>table.groupby(keys, functions)</code> Reshaping To reshape a table use <code>transpose</code>.  to perform pivot table like operations, use: <code>table.pivot(rows, columns, functions)</code> subtotals aside tablite will give you everything Excels pivot table can do. Time series To convert time series use a list comprehension.<code>t1['GMT'] = [timedelta(hours=1) + v for v in t1['date'] ]</code>  to generate a date range use:<code>from Tablite import daterange</code><code>t['date'] = date_range(start=2022/1/1, stop=2023/1/1, step=timedelta(days=1))</code> Categorical Pandas only seems to use this for sorting and grouping.  Tablite table has <code>.sort</code>, <code>.groupby</code> and <code>.pivot</code>  to achieve the same task. Plotting Import your favorite plotting package and feed it the values, such as:<code>import matplotlib.pyplot as plt</code> <code>plt.plot(t['a'],t['b'])</code> <code>plt.showw()</code> Import/Export Tablite supports the same import/export options as pandas.Tablite pegs the free memory before IO and can therefore process larger-than-RAM files. Tablite also guesses the datatypes for all ISOformats and uses multiprocessing and may therefore be faster. Should you want to inspect how guess works, use <code>from tools import guess</code> and try the function out. Gotchas None really. Should you come across something non-pythonic, then please post it on the issue list."},{"location":"reference/base/","title":"Base","text":""},{"location":"reference/base/#tablite.base","title":"<code>tablite.base</code>","text":""},{"location":"reference/base/#tablite.base-attributes","title":"Attributes","text":""},{"location":"reference/base/#tablite.base.log","title":"<code>tablite.base.log = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/base/#tablite.base.file_registry","title":"<code>tablite.base.file_registry = set()</code>  <code>module-attribute</code>","text":""},{"location":"reference/base/#tablite.base-classes","title":"Classes","text":""},{"location":"reference/base/#tablite.base.SimplePage","title":"<code>tablite.base.SimplePage(id, path, len, py_dtype)</code>","text":"<p>             Bases: <code>object</code></p> Source code in <code>tablite/base.py</code> <pre><code>def __init__(self, id, path, len, py_dtype) -&gt; None:\n    self.path = Path(path) / \"pages\" / f\"{id}.npy\"\n    self.len = len\n    self.dtype = py_dtype\n\n    self._incr_refcount()\n</code></pre>"},{"location":"reference/base/#tablite.base.SimplePage-attributes","title":"Attributes","text":""},{"location":"reference/base/#tablite.base.SimplePage.ids","title":"<code>tablite.base.SimplePage.ids = count(start=1)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.SimplePage.refcounts","title":"<code>tablite.base.SimplePage.refcounts = {}</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.SimplePage.autocleanup","title":"<code>tablite.base.SimplePage.autocleanup = True</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.SimplePage.path","title":"<code>tablite.base.SimplePage.path = Path(path) / 'pages' / f'{id}.npy'</code>  <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.SimplePage.len","title":"<code>tablite.base.SimplePage.len = len</code>  <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.SimplePage.dtype","title":"<code>tablite.base.SimplePage.dtype = py_dtype</code>  <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.SimplePage-functions","title":"Functions","text":""},{"location":"reference/base/#tablite.base.SimplePage.__setstate__","title":"<code>tablite.base.SimplePage.__setstate__(state)</code>","text":"<p>when an object is unpickled, say in a case of multi-processing, object.setstate(state) is called instead of init, this means we need to update page refcount as if constructor had been called</p> Source code in <code>tablite/base.py</code> <pre><code>def __setstate__(self, state):\n    \"\"\"\n    when an object is unpickled, say in a case of multi-processing,\n    object.__setstate__(state) is called instead of __init__, this means\n    we need to update page refcount as if constructor had been called\n    \"\"\"\n    self.__dict__.update(state)\n\n    self._incr_refcount()\n</code></pre>"},{"location":"reference/base/#tablite.base.SimplePage.next_id","title":"<code>tablite.base.SimplePage.next_id(path)</code>  <code>classmethod</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>@classmethod\ndef next_id(cls, path):\n    path = Path(path)\n\n    while True:\n        _id = f\"{os.getpid()}-{next(cls.ids)}\"\n        _path = path / \"pages\" / f\"{_id}.npy\"\n\n        if not _path.exists():\n            break  # make sure we don't override existing pages if they are created outside of main thread\n\n    return _id\n</code></pre>"},{"location":"reference/base/#tablite.base.SimplePage.__len__","title":"<code>tablite.base.SimplePage.__len__()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __len__(self):\n    return self.len\n</code></pre>"},{"location":"reference/base/#tablite.base.SimplePage.__repr__","title":"<code>tablite.base.SimplePage.__repr__() -&gt; str</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __repr__(self) -&gt; str:\n    try:\n        return f\"{self.__class__.__name__}({self.path}, {self.get()})\"\n    except FileNotFoundError as e:\n        return f\"{self.__class__.__name__}({self.path}, &lt;{type(e).__name__}&gt;)\"\n    except Exception as e:\n        return f\"{self.__class__.__name__}({self.path}, &lt;{e}&gt;)\"\n</code></pre>"},{"location":"reference/base/#tablite.base.SimplePage.__hash__","title":"<code>tablite.base.SimplePage.__hash__() -&gt; int</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __hash__(self) -&gt; int:\n    return hash(self.path)\n</code></pre>"},{"location":"reference/base/#tablite.base.SimplePage.owns","title":"<code>tablite.base.SimplePage.owns()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def owns(self):\n    parts = self.path.parts\n\n    return all((p in parts for p in Path(Config.pid).parts))\n</code></pre>"},{"location":"reference/base/#tablite.base.SimplePage.__del__","title":"<code>tablite.base.SimplePage.__del__()</code>","text":"<p>When python's reference count for an object is 0, python uses it's garbage collector to remove the object and free the memory. As tablite tables have columns and columns have page and pages have data stored on disk, the space on disk must be freed up as well. This del override assures the cleanup of stored data.</p> Source code in <code>tablite/base.py</code> <pre><code>def __del__(self):\n    \"\"\"When python's reference count for an object is 0, python uses\n    it's garbage collector to remove the object and free the memory.\n    As tablite tables have columns and columns have page and pages have\n    data stored on disk, the space on disk must be freed up as well.\n    This __del__ override assures the cleanup of stored data.\n    \"\"\"\n    if not self.owns():\n        return\n\n    refcount = self.refcounts[self.path] = max(\n        self.refcounts.get(self.path, 0) - 1, 0\n    )\n\n    if refcount &gt; 0:\n        return\n\n    if self.autocleanup:\n        self.path.unlink(True)\n\n    del self.refcounts[self.path]\n</code></pre>"},{"location":"reference/base/#tablite.base.SimplePage.get","title":"<code>tablite.base.SimplePage.get()</code>","text":"<p>loads stored data</p> RETURNS DESCRIPTION <p>np.ndarray: stored data.</p> Source code in <code>tablite/base.py</code> <pre><code>def get(self):\n    \"\"\"loads stored data\n\n    Returns:\n        np.ndarray: stored data.\n    \"\"\"\n    array = load_numpy(self.path)\n    return MetaArray(array, array.dtype, py_dtype=self.dtype)\n</code></pre>"},{"location":"reference/base/#tablite.base.Page","title":"<code>tablite.base.Page(path, array)</code>","text":"<p>             Bases: <code>SimplePage</code></p> PARAMETER  DESCRIPTION <code>path</code> <p>working directory.</p> <p> TYPE: <code>Path</code> </p> <code>array</code> <p>data</p> <p> TYPE: <code>array</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def __init__(self, path, array) -&gt; None:\n    \"\"\"\n    Args:\n        path (Path): working directory.\n        array (np.array): data\n    \"\"\"\n    _id = self.next_id(path)\n\n    type_check(array, np.ndarray)\n\n    if Config.DISK_LIMIT &lt;= 0:\n        pass\n    else:\n        _, _, free = shutil.disk_usage(path)\n        if free - array.nbytes &lt; Config.DISK_LIMIT:\n            msg = \"\\n\".join(\n                [\n                    f\"Disk limit reached: Config.DISK_LIMIT = {Config.DISK_LIMIT:,} bytes.\",\n                    f\"array requires {array.nbytes:,} bytes, but only {free:,} bytes are free.\",\n                    \"To disable this check, use:\",\n                    \"&gt;&gt;&gt; from tablite.config import Config\",\n                    \"&gt;&gt;&gt; Config.DISK_LIMIT = 0\",\n                    \"To free space, clean up Config.workdir:\",\n                    f\"{Config.workdir}\",\n                ]\n            )\n            raise OSError(msg)\n\n    _len = len(array)\n    # type_check(array, MetaArray)\n    if not hasattr(array, \"metadata\"):\n        raise ValueError\n    _dtype = array.metadata[\"py_dtype\"]\n\n    super().__init__(_id, path, _len, _dtype)\n\n    np.save(self.path, array, allow_pickle=True, fix_imports=False)\n    log.debug(f\"Page saved: {self.path}\")\n</code></pre>"},{"location":"reference/base/#tablite.base.Page-attributes","title":"Attributes","text":""},{"location":"reference/base/#tablite.base.Page.ids","title":"<code>tablite.base.Page.ids = count(start=1)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.Page.refcounts","title":"<code>tablite.base.Page.refcounts = {}</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.Page.autocleanup","title":"<code>tablite.base.Page.autocleanup = True</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.Page.path","title":"<code>tablite.base.Page.path = Path(path) / 'pages' / f'{id}.npy'</code>  <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.Page.len","title":"<code>tablite.base.Page.len = len</code>  <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.Page.dtype","title":"<code>tablite.base.Page.dtype = py_dtype</code>  <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.Page-functions","title":"Functions","text":""},{"location":"reference/base/#tablite.base.Page.__setstate__","title":"<code>tablite.base.Page.__setstate__(state)</code>","text":"<p>when an object is unpickled, say in a case of multi-processing, object.setstate(state) is called instead of init, this means we need to update page refcount as if constructor had been called</p> Source code in <code>tablite/base.py</code> <pre><code>def __setstate__(self, state):\n    \"\"\"\n    when an object is unpickled, say in a case of multi-processing,\n    object.__setstate__(state) is called instead of __init__, this means\n    we need to update page refcount as if constructor had been called\n    \"\"\"\n    self.__dict__.update(state)\n\n    self._incr_refcount()\n</code></pre>"},{"location":"reference/base/#tablite.base.Page.next_id","title":"<code>tablite.base.Page.next_id(path)</code>  <code>classmethod</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>@classmethod\ndef next_id(cls, path):\n    path = Path(path)\n\n    while True:\n        _id = f\"{os.getpid()}-{next(cls.ids)}\"\n        _path = path / \"pages\" / f\"{_id}.npy\"\n\n        if not _path.exists():\n            break  # make sure we don't override existing pages if they are created outside of main thread\n\n    return _id\n</code></pre>"},{"location":"reference/base/#tablite.base.Page.__len__","title":"<code>tablite.base.Page.__len__()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __len__(self):\n    return self.len\n</code></pre>"},{"location":"reference/base/#tablite.base.Page.__repr__","title":"<code>tablite.base.Page.__repr__() -&gt; str</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __repr__(self) -&gt; str:\n    try:\n        return f\"{self.__class__.__name__}({self.path}, {self.get()})\"\n    except FileNotFoundError as e:\n        return f\"{self.__class__.__name__}({self.path}, &lt;{type(e).__name__}&gt;)\"\n    except Exception as e:\n        return f\"{self.__class__.__name__}({self.path}, &lt;{e}&gt;)\"\n</code></pre>"},{"location":"reference/base/#tablite.base.Page.__hash__","title":"<code>tablite.base.Page.__hash__() -&gt; int</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __hash__(self) -&gt; int:\n    return hash(self.path)\n</code></pre>"},{"location":"reference/base/#tablite.base.Page.owns","title":"<code>tablite.base.Page.owns()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def owns(self):\n    parts = self.path.parts\n\n    return all((p in parts for p in Path(Config.pid).parts))\n</code></pre>"},{"location":"reference/base/#tablite.base.Page.__del__","title":"<code>tablite.base.Page.__del__()</code>","text":"<p>When python's reference count for an object is 0, python uses it's garbage collector to remove the object and free the memory. As tablite tables have columns and columns have page and pages have data stored on disk, the space on disk must be freed up as well. This del override assures the cleanup of stored data.</p> Source code in <code>tablite/base.py</code> <pre><code>def __del__(self):\n    \"\"\"When python's reference count for an object is 0, python uses\n    it's garbage collector to remove the object and free the memory.\n    As tablite tables have columns and columns have page and pages have\n    data stored on disk, the space on disk must be freed up as well.\n    This __del__ override assures the cleanup of stored data.\n    \"\"\"\n    if not self.owns():\n        return\n\n    refcount = self.refcounts[self.path] = max(\n        self.refcounts.get(self.path, 0) - 1, 0\n    )\n\n    if refcount &gt; 0:\n        return\n\n    if self.autocleanup:\n        self.path.unlink(True)\n\n    del self.refcounts[self.path]\n</code></pre>"},{"location":"reference/base/#tablite.base.Page.get","title":"<code>tablite.base.Page.get()</code>","text":"<p>loads stored data</p> RETURNS DESCRIPTION <p>np.ndarray: stored data.</p> Source code in <code>tablite/base.py</code> <pre><code>def get(self):\n    \"\"\"loads stored data\n\n    Returns:\n        np.ndarray: stored data.\n    \"\"\"\n    array = load_numpy(self.path)\n    return MetaArray(array, array.dtype, py_dtype=self.dtype)\n</code></pre>"},{"location":"reference/base/#tablite.base.Column","title":"<code>tablite.base.Column(path, value=None)</code>","text":"<p>             Bases: <code>object</code></p> <p>Create Column</p> PARAMETER  DESCRIPTION <code>path</code> <p>path of table.yml (defaults: Config.pid_dir)</p> <p> TYPE: <code>Path</code> </p> <code>value</code> <p>Data to store. Defaults to None.</p> <p> TYPE: <code>Iterable</code> DEFAULT: <code>None</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def __init__(self, path, value=None) -&gt; None:\n    \"\"\"Create Column\n\n    Args:\n        path (Path): path of table.yml (defaults: Config.pid_dir)\n        value (Iterable, optional): Data to store. Defaults to None.\n    \"\"\"\n    self.path = path\n    self.pages = []  # keeps pointers to instances of Page\n    if value is not None:\n        self.extend(value)\n</code></pre>"},{"location":"reference/base/#tablite.base.Column-attributes","title":"Attributes","text":""},{"location":"reference/base/#tablite.base.Column.path","title":"<code>tablite.base.Column.path = path</code>  <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.Column.pages","title":"<code>tablite.base.Column.pages = []</code>  <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.Column-functions","title":"Functions","text":""},{"location":"reference/base/#tablite.base.Column.__len__","title":"<code>tablite.base.Column.__len__()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __len__(self):\n    return sum(len(p) for p in self.pages)\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__repr__","title":"<code>tablite.base.Column.__repr__()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __repr__(self):\n    return f\"{self.__class__.__name__}({self.path}, {self[:]})\"\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.repaginate","title":"<code>tablite.base.Column.repaginate()</code>","text":"<p>resizes pages to Config.PAGE_SIZE</p> Source code in <code>tablite/base.py</code> <pre><code>def repaginate(self):\n    \"\"\"resizes pages to Config.PAGE_SIZE\"\"\"\n    from tablite.nimlite import repaginate as _repaginate\n\n    _repaginate(self)\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.extend","title":"<code>tablite.base.Column.extend(value)</code>","text":"<p>extends the column.</p> PARAMETER  DESCRIPTION <code>value</code> <p>data</p> <p> TYPE: <code>ndarray</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def extend(self, value):  # USER FUNCTION.\n    \"\"\"extends the column.\n\n    Args:\n        value (np.ndarray): data\n    \"\"\"\n    if isinstance(value, Column):\n        self.pages.extend(value.pages[:])\n        return\n    elif isinstance(value, np.ndarray):\n        pass\n    elif isinstance(value, (list, tuple)):\n        value = list_to_np_array(value)\n    else:\n        raise TypeError(f\"Cannot extend Column with {type(value)}\")\n    type_check(value, np.ndarray)\n    for array in self._paginate(value):\n        self.pages.append(Page(path=self.path, array=array))\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.clear","title":"<code>tablite.base.Column.clear()</code>","text":"<p>clears the column. Like list().clear()</p> Source code in <code>tablite/base.py</code> <pre><code>def clear(self):\n    \"\"\"\n    clears the column. Like list().clear()\n    \"\"\"\n    self.pages.clear()\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.getpages","title":"<code>tablite.base.Column.getpages(item)</code>","text":"<p>public non-user function to identify any pages + slices of data to be retrieved given a slice (item)</p> PARAMETER  DESCRIPTION <code>item</code> <p>target slice of data</p> <p> TYPE: <code>(int, slice)</code> </p> RETURNS DESCRIPTION <p>list of pages/np.ndarrays.</p> <p>Example: [Page(1), Page(2), np.ndarray([4,5,6], int64)] This helps, for example when creating a copy, as the copy can reference the pages 1 and 2 and only need to store the np.ndarray that is unique to it.</p> Source code in <code>tablite/base.py</code> <pre><code>def getpages(self, item):\n    \"\"\"public non-user function to identify any pages + slices\n    of data to be retrieved given a slice (item)\n\n    Args:\n        item (int,slice): target slice of data\n\n    Returns:\n        list of pages/np.ndarrays.\n\n    Example: [Page(1), Page(2), np.ndarray([4,5,6], int64)]\n    This helps, for example when creating a copy, as the copy\n    can reference the pages 1 and 2 and only need to store\n    the np.ndarray that is unique to it.\n    \"\"\"\n    # internal function\n    if isinstance(item, int):\n        if item &lt; 0:\n            item = len(self) + item\n        item = slice(item, item + 1, 1)\n\n    type_check(item, slice)\n    is_reversed = False if (item.step is None or item.step &gt; 0) else True\n\n    length = len(self)\n    scan_item = slice(*item.indices(length))\n    range_item = range(*item.indices(length))\n\n    pages = []\n    start, end = 0, 0\n    for page in self.pages:\n        start, end = end, end + page.len\n        if is_reversed:\n            if start &gt; scan_item.start:\n                break\n            if end &lt; scan_item.stop:\n                continue\n        else:\n            if start &gt; scan_item.stop:\n                break\n            if end &lt; scan_item.start:\n                continue\n        ro = intercept(range(start, end), range_item)\n        if len(ro) == 0:\n            continue\n        elif len(ro) == page.len:  # share the whole immutable page\n            pages.append(page)\n        else:  # fetch the slice and filter it.\n            search_slice = slice(ro.start - start, ro.stop - start, ro.step)\n            np_arr = load_numpy(page.path)\n            match = np_arr[search_slice]\n            pages.append(match)\n\n    if is_reversed:\n        pages.reverse()\n        for ix, page in enumerate(pages):\n            if isinstance(page, SimplePage):\n                data = page.get()\n                pages[ix] = np.flip(data)\n            else:\n                pages[ix] = np.flip(page)\n\n    return pages\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.iter_by_page","title":"<code>tablite.base.Column.iter_by_page()</code>","text":"<p>iterates over the column, page by page. This method minimizes the number of reads.</p> RETURNS DESCRIPTION <p>generator of tuple: start: int end: int data: np.ndarray</p> Source code in <code>tablite/base.py</code> <pre><code>def iter_by_page(self):\n    \"\"\"iterates over the column, page by page.\n    This method minimizes the number of reads.\n\n    Returns:\n        generator of tuple:\n            start: int\n            end: int\n            data: np.ndarray\n    \"\"\"\n    start, end = 0, 0\n    for page in self.pages:\n        start, end = end, end + page.len\n        yield start, end, page\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__getitem__","title":"<code>tablite.base.Column.__getitem__(item)</code>","text":"<p>gets numpy array.</p> PARAMETER  DESCRIPTION <code>item</code> <p>slice of column</p> <p> TYPE: <code>int OR slice</code> </p> RETURNS DESCRIPTION <p>np.ndarray: results as numpy array.</p> <p>Remember:</p> <pre><code>&gt;&gt;&gt; R = np.array([0,1,2,3,4,5])\n&gt;&gt;&gt; R[3]\n3\n&gt;&gt;&gt; R[3:4]\narray([3])\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def __getitem__(self, item):  # USER FUNCTION.\n    \"\"\"gets numpy array.\n\n    Args:\n        item (int OR slice): slice of column\n\n    Returns:\n        np.ndarray: results as numpy array.\n\n    Remember:\n    ```\n    &gt;&gt;&gt; R = np.array([0,1,2,3,4,5])\n    &gt;&gt;&gt; R[3]\n    3\n    &gt;&gt;&gt; R[3:4]\n    array([3])\n    ```\n    \"\"\"\n    result = []\n    for element in self.getpages(item):\n        if isinstance(element, SimplePage):\n            result.append(element.get())\n        else:\n            result.append(element)\n\n    if result:\n        arr = np_type_unify(result)\n    else:\n        arr = np.array([])\n\n    if isinstance(item, int):\n        if len(arr) == 0:\n            raise IndexError(\n                f\"index {item} is out of bounds for axis 0 with size {len(self)}\"\n            )\n        return numpy_to_python(arr[0])\n    else:\n        return arr\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__setitem__","title":"<code>tablite.base.Column.__setitem__(key, value)</code>","text":"<p>sets values.</p> PARAMETER  DESCRIPTION <code>key</code> <p>selector</p> <p> TYPE: <code>(int, slice)</code> </p> <code>value</code> <p>values to insert</p> <p> TYPE: <code>any</code> </p> RAISES DESCRIPTION <code>KeyError</code> <p>Following normal slicing rules</p> Source code in <code>tablite/base.py</code> <pre><code>def __setitem__(self, key, value):  # USER FUNCTION.\n    \"\"\"sets values.\n\n    Args:\n        key (int,slice): selector\n        value (any): values to insert\n\n    Raises:\n        KeyError: Following normal slicing rules\n    \"\"\"\n    if isinstance(key, int):\n        self._setitem_integer_key(key, value)\n\n    elif isinstance(key, slice):\n        if not isinstance(value, np.ndarray):\n            value = list_to_np_array(value)\n        type_check(value, np.ndarray)\n\n        if key.start is None and key.stop is None and key.step in (None, 1):\n            self._setitem_replace_all(key, value)\n        elif key.start is not None and key.stop is None and key.step in (None, 1):\n            self._setitem_extend(key, value)\n        elif key.stop is not None and key.start is None and key.step in (None, 1):\n            self._setitem_prextend(key, value)\n        elif (\n            key.step in (None, 1) and key.start is not None and key.stop is not None\n        ):\n            self._setitem_insert(key, value)\n        elif key.step not in (None, 1):\n            self._setitem_update(key, value)\n        else:\n            raise KeyError(f\"bad key: {key}\")\n    else:\n        raise KeyError(f\"bad key: {key}\")\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__delitem__","title":"<code>tablite.base.Column.__delitem__(key)</code>","text":"<p>deletes items selected by key</p> PARAMETER  DESCRIPTION <code>key</code> <p>selector</p> <p> TYPE: <code>(int, slice)</code> </p> RAISES DESCRIPTION <code>KeyError</code> <p>following normal slicing rules.</p> Source code in <code>tablite/base.py</code> <pre><code>def __delitem__(self, key):  # USER FUNCTION\n    \"\"\"deletes items selected by key\n\n    Args:\n        key (int,slice): selector\n\n    Raises:\n        KeyError: following normal slicing rules.\n    \"\"\"\n    if isinstance(key, int):\n        self._del_by_int(key)\n    elif isinstance(key, slice):\n        self._del_by_slice(key)\n    else:\n        raise KeyError(f\"bad key: {key}\")\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.get_by_indices","title":"<code>tablite.base.Column.get_by_indices(indices: Union[List[int], np.ndarray]) -&gt; np.ndarray</code>","text":"<p>retrieves values from column given a set of indices.</p> PARAMETER  DESCRIPTION <code>indices</code> <p>targets</p> <p> TYPE: <code>array</code> </p> <p>This method uses np.take, is faster than iterating over rows. Examples:</p> <pre><code>&gt;&gt;&gt; indices = np.array(list(range(3,700_700, 426)))\n&gt;&gt;&gt; arr = np.array(list(range(2_000_000)))\nPythonic:\n&gt;&gt;&gt; [v for i,v in enumerate(arr) if i in indices]\nNumpyionic:\n&gt;&gt;&gt; np.take(arr, indices)\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def get_by_indices(self, indices: Union[List[int], np.ndarray]) -&gt; np.ndarray:\n    \"\"\"retrieves values from column given a set of indices.\n\n    Args:\n        indices (np.array): targets\n\n    This method uses np.take, is faster than iterating over rows.\n    Examples:\n    ```\n    &gt;&gt;&gt; indices = np.array(list(range(3,700_700, 426)))\n    &gt;&gt;&gt; arr = np.array(list(range(2_000_000)))\n    Pythonic:\n    &gt;&gt;&gt; [v for i,v in enumerate(arr) if i in indices]\n    Numpyionic:\n    &gt;&gt;&gt; np.take(arr, indices)\n    ```\n    \"\"\"\n    type_check(indices, np.ndarray)\n\n    dtypes = set()\n    values = np.empty(\n        indices.shape, dtype=object\n    )  # placeholder for the indexed values.\n\n    for start, end, page in self.iter_by_page():\n        range_match = np.asarray(((indices &gt;= start) &amp; (indices &lt; end)) | (indices == -1)).nonzero()[0]\n        if len(range_match):\n            # only fetch the data if there's a range match!\n            data = page.get() \n            sub_index = np.take(indices, range_match)\n            # sub_index2 otherwise will raise index error where len(data) &gt; (-1 - start)\n            # so the clause below is required:\n            if len(data) &gt; (-1 - start):\n                sub_index = np.where(sub_index == -1, -1, sub_index - start)\n            arr = np.take(data, sub_index)\n            dtypes.add(arr.dtype)\n            np.put(values, range_match, arr)\n\n    if len(dtypes) == 1:  # simplify the datatype\n        dtype = next(iter(dtypes))\n        values = np.array(values, dtype=dtype)\n    return values\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__iter__","title":"<code>tablite.base.Column.__iter__()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __iter__(self):  # USER FUNCTION.\n    for page in self.pages:\n        data = page.get()\n        for value in data:\n            yield value\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__eq__","title":"<code>tablite.base.Column.__eq__(other)</code>","text":"<p>compares two columns. Like <code>list1 == list2</code></p> Source code in <code>tablite/base.py</code> <pre><code>def __eq__(self, other):  # USER FUNCTION.\n    \"\"\"\n    compares two columns. Like `list1 == list2`\n    \"\"\"\n    if len(self) != len(other):  # quick cheap check.\n        return False\n\n    if isinstance(other, (list, tuple)):\n        return all(a == b for a, b in zip(self[:], other))\n\n    elif isinstance(other, Column):\n        if self.pages == other.pages:  # special case.\n            return True\n\n        # are the pages of same size?\n        if len(self.pages) == len(other.pages):\n            if [p.len for p in self.pages] == [p.len for p in other.pages]:\n                for a, b in zip(self.pages, other.pages):\n                    if not (a.get() == b.get()).all():\n                        return False\n                return True\n        # to bad. Element comparison it is then:\n        for a, b in zip(iter(self), iter(other)):\n            if a != b:\n                return False\n        return True\n\n    elif isinstance(other, np.ndarray):\n        start, end = 0, 0\n        for p in self.pages:\n            start, end = end, end + p.len\n            if not (p.get() == other[start:end]).all():\n                return False\n        return True\n    else:\n        raise TypeError(f\"Cannot compare {self.__class__} with {type(other)}\")\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__ne__","title":"<code>tablite.base.Column.__ne__(other)</code>","text":"<p>compares two columns. Like <code>list1 != list2</code></p> Source code in <code>tablite/base.py</code> <pre><code>def __ne__(self, other):  # USER FUNCTION\n    \"\"\"\n    compares two columns. Like `list1 != list2`\n    \"\"\"\n    if len(self) != len(other):  # quick cheap check.\n        return True\n\n    if isinstance(other, (list, tuple)):\n        return any(a != b for a, b in zip(self[:], other))\n\n    elif isinstance(other, Column):\n        if self.pages == other.pages:  # special case.\n            return False\n\n        # are the pages of same size?\n        if len(self.pages) == len(other.pages):\n            if [p.len for p in self.pages] == [p.len for p in other.pages]:\n                for a, b in zip(self.pages, other.pages):\n                    if not (a.get() == b.get()).all():\n                        return True\n                return False\n        # to bad. Element comparison it is then:\n        for a, b in zip(iter(self), iter(other)):\n            if a != b:\n                return True\n        return False\n\n    elif isinstance(other, np.ndarray):\n        start, end = 0, 0\n        for p in self.pages:\n            start, end = end, end + p.len\n            if (p.get() != other[start:end]).any():\n                return True\n        return False\n    else:\n        raise TypeError(f\"Cannot compare {self.__class__} with {type(other)}\")\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.copy","title":"<code>tablite.base.Column.copy()</code>","text":"<p>returns deep=copy of Column</p> RETURNS DESCRIPTION <p>Column</p> Source code in <code>tablite/base.py</code> <pre><code>def copy(self):\n    \"\"\"returns deep=copy of Column\n\n    Returns:\n        Column\n    \"\"\"\n    cp = Column(path=self.path)\n    cp.pages = self.pages[:]\n    return cp\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__copy__","title":"<code>tablite.base.Column.__copy__()</code>","text":"<p>see copy</p> Source code in <code>tablite/base.py</code> <pre><code>def __copy__(self):\n    \"\"\"see copy\"\"\"\n    return self.copy()\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__imul__","title":"<code>tablite.base.Column.__imul__(other)</code>","text":"<p>Repeats instance of column N times. Like list() * N</p> <p>Example:</p> <pre><code>&gt;&gt;&gt; one = Column(data=[1,2])\n&gt;&gt;&gt; one *= 5\n&gt;&gt;&gt; one\n[1,2, 1,2, 1,2, 1,2, 1,2]\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def __imul__(self, other):\n    \"\"\"\n    Repeats instance of column N times. Like list() * N\n\n    Example:\n    ```\n    &gt;&gt;&gt; one = Column(data=[1,2])\n    &gt;&gt;&gt; one *= 5\n    &gt;&gt;&gt; one\n    [1,2, 1,2, 1,2, 1,2, 1,2]\n    ```\n    \"\"\"\n    if not (isinstance(other, int) and other &gt; 0):\n        raise TypeError(\n            f\"a column can be repeated an integer number of times, not {type(other)} number of times\"\n        )\n    self.pages = self.pages[:] * other\n    return self\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__mul__","title":"<code>tablite.base.Column.__mul__(other)</code>","text":"<p>Repeats instance of column N times. Like list() * N</p> <p>Example:</p> <pre><code>&gt;&gt;&gt; one = Column(data=[1,2])\n&gt;&gt;&gt; two = one * 5\n&gt;&gt;&gt; two\n[1,2, 1,2, 1,2, 1,2, 1,2]\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def __mul__(self, other):\n    \"\"\"\n    Repeats instance of column N times. Like list() * N\n\n    Example:\n    ```\n    &gt;&gt;&gt; one = Column(data=[1,2])\n    &gt;&gt;&gt; two = one * 5\n    &gt;&gt;&gt; two\n    [1,2, 1,2, 1,2, 1,2, 1,2]\n    ```\n    \"\"\"\n    if not isinstance(other, int):\n        raise TypeError(\n            f\"a column can be repeated an integer number of times, not {type(other)} number of times\"\n        )\n    cp = self.copy()\n    cp *= other\n    return cp\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__iadd__","title":"<code>tablite.base.Column.__iadd__(other)</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __iadd__(self, other):\n    if isinstance(other, (list, tuple)):\n        other = list_to_np_array(other)\n        self.extend(other)\n    elif isinstance(other, Column):\n        self.pages.extend(other.pages[:])\n    else:\n        raise TypeError(f\"{type(other)} not supported.\")\n    return self\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.__contains__","title":"<code>tablite.base.Column.__contains__(item)</code>","text":"<p>determines if item is in the Column. Similar to <code>'x' in ['a','b','c']</code> returns boolean</p> PARAMETER  DESCRIPTION <code>item</code> <p>value to search for</p> <p> TYPE: <code>any</code> </p> RETURNS DESCRIPTION <code>bool</code> <p>True if item exists in column.</p> Source code in <code>tablite/base.py</code> <pre><code>def __contains__(self, item):\n    \"\"\"determines if item is in the Column.\n    Similar to `'x' in ['a','b','c']`\n    returns boolean\n\n    Args:\n        item (any): value to search for\n\n    Returns:\n        bool: True if item exists in column.\n    \"\"\"\n    for page in set(self.pages):\n        if item in page.get():  # x in np.ndarray([...]) uses np.any(arr, value)\n            return True\n    return False\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.remove_all","title":"<code>tablite.base.Column.remove_all(*values)</code>","text":"<p>removes all values of <code>values</code></p> Source code in <code>tablite/base.py</code> <pre><code>def remove_all(self, *values):\n    \"\"\"\n    removes all values of `values`\n    \"\"\"\n    type_check(values, tuple)\n    if isinstance(values[0], tuple):\n        values = values[0]\n    to_remove = list_to_np_array(values)\n    for index, page in enumerate(self.pages):\n        data = page.get()\n        bitmask = np.isin(data, to_remove)  # identify elements to remove.\n        if bitmask.any():\n            bitmask = np.invert(bitmask)  # turn bitmask around to keep.\n            new_data = np.compress(bitmask, data)\n            new_page = Page(self.path, new_data)\n            self.pages[index] = new_page\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.replace","title":"<code>tablite.base.Column.replace(mapping)</code>","text":"<p>replaces values using a mapping.</p> PARAMETER  DESCRIPTION <code>mapping</code> <p>{value to replace: new value, ...}</p> <p> TYPE: <code>dict</code> </p> <p>Example:</p> <pre><code>&gt;&gt;&gt; t = Table(columns={'A': [1,2,3,4]})\n&gt;&gt;&gt; t['A'].replace({2:20,4:40})\n&gt;&gt;&gt; t[:]\nnp.ndarray([1,20,3,40])\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def replace(self, mapping):\n    \"\"\"\n    replaces values using a mapping.\n\n    Args:\n        mapping (dict): {value to replace: new value, ...}\n\n    Example:\n    ```\n    &gt;&gt;&gt; t = Table(columns={'A': [1,2,3,4]})\n    &gt;&gt;&gt; t['A'].replace({2:20,4:40})\n    &gt;&gt;&gt; t[:]\n    np.ndarray([1,20,3,40])\n    ```\n    \"\"\"\n    type_check(mapping, dict)\n    to_replace = np.array(list(mapping.keys()))\n    for index, page in enumerate(self.pages):\n        data = page.get()\n        bitmask = np.isin(data, to_replace)  # identify elements to replace.\n        if bitmask.any():\n            warray = np.compress(bitmask, data)\n            py_dtype = page.dtype\n            for ix, v in enumerate(warray):\n                old_py_val = numpy_to_python(v)\n                new_py_val = mapping[old_py_val]\n                old_dt = type(old_py_val)\n                new_dt = type(new_py_val)\n\n                warray[ix] = new_py_val\n\n                py_dtype[new_dt] = py_dtype.get(new_dt, 0) + 1\n                py_dtype[old_dt] = py_dtype.get(old_dt, 0) - 1\n\n                if py_dtype[old_dt] &lt;= 0:\n                    del py_dtype[old_dt]\n\n            data[bitmask] = warray\n            self.pages[index] = Page(path=self.path, array=data)\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.types","title":"<code>tablite.base.Column.types()</code>","text":"<p>returns dict with python datatypes</p> RETURNS DESCRIPTION <code>dict</code> <p>frequency of occurrence of python datatypes</p> Source code in <code>tablite/base.py</code> <pre><code>def types(self):\n    \"\"\"\n    returns dict with python datatypes\n\n    Returns:\n        dict: frequency of occurrence of python datatypes\n    \"\"\"\n    d = Counter()\n    for page in self.pages:\n        assert isinstance(page.dtype, dict)\n        d += page.dtype\n    return dict(d)\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.index","title":"<code>tablite.base.Column.index()</code>","text":"<p>returns dict with { unique entry : list of indices }</p> <p>example:</p> <pre><code>&gt;&gt;&gt; c = Column(data=['a','b','a','c','b'])\n&gt;&gt;&gt; c.index()\n{'a':[0,2], 'b': [1,4], 'c': [3]}\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def index(self):\n    \"\"\"\n    returns dict with { unique entry : list of indices }\n\n    example:\n    ```\n    &gt;&gt;&gt; c = Column(data=['a','b','a','c','b'])\n    &gt;&gt;&gt; c.index()\n    {'a':[0,2], 'b': [1,4], 'c': [3]}\n    ```\n    \"\"\"\n    d = defaultdict(list)\n    for ix, v in enumerate(self.__iter__()):\n        d[v].append(ix)\n    return dict(d)\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.unique","title":"<code>tablite.base.Column.unique()</code>","text":"<p>returns unique list of values.</p> <p>example:</p> <pre><code>&gt;&gt;&gt; c = Column(data=['a','b','a','c','b'])\n&gt;&gt;&gt; c.unqiue()\n['a','b','c']\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def unique(self):\n    \"\"\"\n    returns unique list of values.\n\n    example:\n    ```\n    &gt;&gt;&gt; c = Column(data=['a','b','a','c','b'])\n    &gt;&gt;&gt; c.unqiue()\n    ['a','b','c']\n    ```\n    \"\"\"\n    arrays = []\n    for page in set(self.pages):\n        try:  # when it works, numpy is fast...\n            arrays.append(np.unique(page.get()))\n        except TypeError:  # ...but np.unique cannot handle Nones.\n            arrays.append(multitype_set(page.get()))\n    union = np_type_unify(arrays)\n    try:\n        return np.unique(union)\n    except MemoryError:\n        return np.array(set(union))\n    except TypeError:\n        return multitype_set(union)\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.histogram","title":"<code>tablite.base.Column.histogram()</code>","text":"<p>returns 2 arrays: unique elements and count of each element</p> <p>example:</p> <pre><code>&gt;&gt;&gt; c = Column(data=['a','b','a','c','b'])\n&gt;&gt;&gt; c.histogram()\n{'a':2,'b':2,'c':1}\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def histogram(self):\n    \"\"\"\n    returns 2 arrays: unique elements and count of each element\n\n    example:\n    ```\n    &gt;&gt;&gt; c = Column(data=['a','b','a','c','b'])\n    &gt;&gt;&gt; c.histogram()\n    {'a':2,'b':2,'c':1}\n    ```\n    \"\"\"\n    d = defaultdict(int)\n    for page in self.pages:\n        try:\n            uarray, carray = np.unique(page.get(), return_counts=True)\n        except TypeError:\n            uarray = page.get()\n            carray = repeat(1, len(uarray))\n\n        for i, c in zip(uarray, carray):\n            v = numpy_to_python(i)\n            d[(type(v), v)] += numpy_to_python(c)\n    u = [v for _, v in d.keys()]\n    c = list(d.values())\n    return u, c  # unique, counts\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.statistics","title":"<code>tablite.base.Column.statistics()</code>","text":"<p>provides summary statistics.</p> RETURNS DESCRIPTION <code>dict</code> <p>returns dict with:</p> <ul> <li>min (int/float, length of str, date)</li> </ul> <ul> <li>max (int/float, length of str, date)</li> </ul> <ul> <li>mean (int/float, length of str, date)</li> </ul> <ul> <li>median (int/float, length of str, date)</li> </ul> <ul> <li>stdev (int/float, length of str, date)</li> </ul> <ul> <li>mode (int/float, length of str, date)</li> </ul> <ul> <li>distinct (int/float, length of str, date)</li> </ul> <ul> <li>iqr (int/float, length of str, date)</li> </ul> <ul> <li>sum (int/float, length of str, date)</li> </ul> <ul> <li>histogram (see .histogram)</li> </ul> Source code in <code>tablite/base.py</code> <pre><code>def statistics(self):\n    \"\"\"provides summary statistics.\n\n    Returns:\n        dict: returns dict with:\n        - min (int/float, length of str, date)\n        - max (int/float, length of str, date)\n        - mean (int/float, length of str, date)\n        - median (int/float, length of str, date)\n        - stdev (int/float, length of str, date)\n        - mode (int/float, length of str, date)\n        - distinct (int/float, length of str, date)\n        - iqr (int/float, length of str, date)\n        - sum (int/float, length of str, date)\n        - histogram (see .histogram)\n    \"\"\"\n    values, counts = self.histogram()\n    return summary_statistics(values, counts)\n</code></pre>"},{"location":"reference/base/#tablite.base.Column.count","title":"<code>tablite.base.Column.count(item)</code>","text":"<p>counts appearances of item in column.</p> <p>Note that in python, <code>True == 1</code> and <code>False == 0</code>, whereby the following difference occurs:</p> <p>in python:</p> <pre><code>&gt;&gt;&gt; L = [1, True]\n&gt;&gt;&gt; L.count(True)\n2\n</code></pre> <p>in tablite:</p> <pre><code>&gt;&gt;&gt; t = Table({'L': [1,True]})\n&gt;&gt;&gt; t['L'].count(True)\n1\n</code></pre> PARAMETER  DESCRIPTION <code>item</code> <p>target item</p> <p> TYPE: <code>Any</code> </p> RETURNS DESCRIPTION <code>int</code> <p>number of occurrences of item.</p> Source code in <code>tablite/base.py</code> <pre><code>def count(self, item):\n    \"\"\"counts appearances of item in column.\n\n    Note that in python, `True == 1` and `False == 0`,\n    whereby the following difference occurs:\n\n    in python:\n    ```\n    &gt;&gt;&gt; L = [1, True]\n    &gt;&gt;&gt; L.count(True)\n    2\n    ```\n    in tablite:\n    ```\n    &gt;&gt;&gt; t = Table({'L': [1,True]})\n    &gt;&gt;&gt; t['L'].count(True)\n    1\n    ```\n\n    Args:\n        item (Any): target item\n\n    Returns:\n        int: number of occurrences of item.\n    \"\"\"\n    result = 0\n    for page in self.pages:\n        data = page.get()\n        if data.dtype != \"O\":\n            result += np.nonzero(page.get() == item)[0].shape[0]\n            # what happens here ---^ below:\n            # arr = page.get()\n            # &gt;&gt;&gt; arr\n            # array([1,2,3,4,3], int64)\n            # &gt;&gt;&gt; (arr == 3)\n            # array([False, False,  True, False,  True])\n            # &gt;&gt;&gt; np.nonzero(arr==3)\n            # (array([2,4], dtype=int64), )  &lt;-- tuple!\n            # &gt;&gt;&gt; np.nonzero(page.get() == item)[0]\n            # array([2,4])\n            # &gt;&gt;&gt; np.nonzero(page.get() == item)[0].shape\n            # (2, )\n            # &gt;&gt;&gt; np.nonzero(page.get() == item)[0].shape[0]\n            # 2\n        else:\n            result += sum(1 for i in data if type(i) == type(item) and i == item)\n    return result\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable","title":"<code>tablite.base.BaseTable(columns: [dict, None] = None, headers: [list, None] = None, rows: [list, None] = None, _path: [Path, None] = None)</code>","text":"<p>             Bases: <code>object</code></p> <p>creates Table</p> PARAMETER  DESCRIPTION <code>EITHER</code> <p>columns (dict, optional): dict with column names as keys, values as lists. Example: t = Table(columns={\"a\": [1, 2], \"b\": [3, 4]})</p> <p> </p> <code>_path</code> <p>path to main process working directory.</p> <p> TYPE: <code>Path</code> DEFAULT: <code>None</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def __init__(\n    self,\n    columns: [dict, None] = None,\n    headers: [list, None] = None,\n    rows: [list, None] = None,\n    _path: [Path, None] = None,\n) -&gt; None:\n    \"\"\"creates Table\n\n    Args:\n        EITHER:\n            columns (dict, optional): dict with column names as keys, values as lists.\n            Example: t = Table(columns={\"a\": [1, 2], \"b\": [3, 4]})\n        OR\n            headers (list of strings, optional): list of column names.\n            rows (list of tuples or lists, optional): values for columns\n            Example: t = Table(headers=[\"a\", \"b\"], rows=[[1,3], [2,4]])\n\n        _path (pathlib.Path, optional): path to main process working directory.\n    \"\"\"\n    if _path is None:\n        if self._pid_dir is None:\n            self._pid_dir = Path(Config.workdir) / Config.pid\n            if not self._pid_dir.exists():\n                self._pid_dir.mkdir()\n                (self._pid_dir / \"pages\").mkdir()\n            register(self._pid_dir)\n\n        _path = Path(self._pid_dir)\n        # if path exists under the given PID it will be overwritten.\n        # this can only happen if the process previously was SIGKILLed.\n    type_check(_path, Path)\n    self.path = _path  # filename used during multiprocessing.\n    self.columns = {}  # maps colunn names to instances of Column.\n\n    # user friendly features.\n    if columns and any((headers, rows)):\n        raise ValueError(\"Either columns as dict OR headers and rows. Not both.\")\n\n    if headers and rows:\n        rotated = list(zip(*rows))\n        columns = {k: v for k, v in zip(headers, rotated)}\n\n    if columns:\n        type_check(columns, dict)\n        for k, v in columns.items():\n            self.__setitem__(k, v)\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable-attributes","title":"Attributes","text":""},{"location":"reference/base/#tablite.base.BaseTable.path","title":"<code>tablite.base.BaseTable.path = _path</code>  <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.BaseTable.columns","title":"<code>tablite.base.BaseTable.columns = {}</code>  <code>instance-attribute</code>","text":""},{"location":"reference/base/#tablite.base.BaseTable.rows","title":"<code>tablite.base.BaseTable.rows</code>  <code>property</code>","text":"<p>enables row based iteration in python types.</p> <p>Example:</p> <pre><code>for row in Table.rows:\n    print(row)\n</code></pre> <p>Yields:     tuple: values is same order as columns.</p>"},{"location":"reference/base/#tablite.base.BaseTable-functions","title":"Functions","text":""},{"location":"reference/base/#tablite.base.BaseTable.__str__","title":"<code>tablite.base.BaseTable.__str__()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __str__(self):  # USER FUNCTION.\n    return f\"{self.__class__.__name__}({len(self.columns):,} columns, {len(self):,} rows)\"\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.__repr__","title":"<code>tablite.base.BaseTable.__repr__()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __repr__(self):\n    return self.__str__()\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.nbytes","title":"<code>tablite.base.BaseTable.nbytes()</code>","text":"<p>finds the total bytes of the table on disk</p> RETURNS DESCRIPTION <code>tuple</code> <p>int: real bytes used on disk int: total bytes used if flattened</p> Source code in <code>tablite/base.py</code> <pre><code>def nbytes(self):  # USER FUNCTION.\n    \"\"\"finds the total bytes of the table on disk\n\n    Returns:\n        tuple:\n            int: real bytes used on disk\n            int: total bytes used if flattened\n    \"\"\"\n    real = {}\n    total = 0\n    for column in self.columns.values():\n        for page in set(column.pages):\n            real[page] = page.path.stat().st_size\n        for page in column.pages:\n            total += real[page]\n    return sum(real.values()), total\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.items","title":"<code>tablite.base.BaseTable.items()</code>","text":"<p>returns table as dict</p> RETURNS DESCRIPTION <code>dict</code> <p>Table as dict <code>{column_name: [values], ...}</code></p> Source code in <code>tablite/base.py</code> <pre><code>def items(self):  # USER FUNCTION.\n    \"\"\"returns table as dict\n\n    Returns:\n        dict: Table as dict `{column_name: [values], ...}`\n    \"\"\"\n    return {\n        name: column[:].tolist() for name, column in self.columns.items()\n    }.items()\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.__delitem__","title":"<code>tablite.base.BaseTable.__delitem__(key)</code>","text":"<p>Examples:</p> <pre><code>&gt;&gt;&gt; del table['a']  # removes column 'a'\n&gt;&gt;&gt; del table[-3:]  # removes last 3 rows from all columns.\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def __delitem__(self, key):  # USER FUNCTION.\n    \"\"\"\n    Examples:\n    ```\n    &gt;&gt;&gt; del table['a']  # removes column 'a'\n    &gt;&gt;&gt; del table[-3:]  # removes last 3 rows from all columns.\n    ```\n    \"\"\"\n    if isinstance(key, (int, slice)):\n        for column in self.columns.values():\n            del column[key]\n    elif key in self.columns:\n        del self.columns[key]\n    else:\n        raise KeyError(f\"Key not found: {key}\")\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.__setitem__","title":"<code>tablite.base.BaseTable.__setitem__(key, value)</code>","text":"<p>table behaves like a dict. Args:     key (str or hashable): column name     value (iterable): list, tuple or nd.array with values.</p> <p>As Table now accepts the keyword <code>columns</code> as a dict:</p> <pre><code>&gt;&gt;&gt; t = Table(columns={'b':[4,5,6], 'c':[7,8,9]})\n</code></pre> <p>and the header/data combinations:</p> <pre><code>&gt;&gt;&gt; t = Table(header=['b','c'], data=[[4,5,6],[7,8,9]])\n</code></pre> <p>This has the side-benefit that tuples now can be used as headers.</p> Source code in <code>tablite/base.py</code> <pre><code>def __setitem__(self, key, value):  # USER FUNCTION\n    \"\"\"table behaves like a dict.\n    Args:\n        key (str or hashable): column name\n        value (iterable): list, tuple or nd.array with values.\n\n    As Table now accepts the keyword `columns` as a dict:\n    ```\n    &gt;&gt;&gt; t = Table(columns={'b':[4,5,6], 'c':[7,8,9]})\n    ```\n    and the header/data combinations:\n    ```\n    &gt;&gt;&gt; t = Table(header=['b','c'], data=[[4,5,6],[7,8,9]])\n    ```\n    This has the side-benefit that tuples now can be used as headers.\n    \"\"\"\n    if value is None:\n        self.columns[key] = Column(self.path, value=None)\n    elif isinstance(value, (list, tuple)):\n        value = list_to_np_array(value)\n        self.columns[key] = Column(self.path, value)\n    elif isinstance(value, (np.ndarray)):\n        self.columns[key] = Column(self.path, value)\n    elif isinstance(value, Column):\n        self.columns[key] = value\n    else:\n        raise TypeError(f\"{type(value)} not supported.\")\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.__getitem__","title":"<code>tablite.base.BaseTable.__getitem__(keys)</code>","text":"<p>Enables selection of columns and rows</p> PARAMETER  DESCRIPTION <code>keys</code> <p> TYPE: <code>column name, integer or slice</code> </p> <code>Examples</code> <p> </p> <code>&gt;&gt;&gt;</code> <p>10]                        selects first 10 rows from all columns</p> <p> TYPE: <code>table[</code> </p> <code>&gt;&gt;&gt;</code> <p>20:3] selects column 'b' and 'c' and 'a' twice for a slice.</p> <p> TYPE: <code>table['b', 'a', 'a', 'c', 2</code> </p> <p>Raises:     KeyError: if key is not found.     TypeError: if key is not a string, integer or slice.</p> RETURNS DESCRIPTION <code>Table</code> <p>returns columns in same order as selection.</p> Source code in <code>tablite/base.py</code> <pre><code>def __getitem__(self, keys):  # USER FUNCTION\n    \"\"\"\n    Enables selection of columns and rows\n\n    Args:\n        keys (column name, integer or slice):\n        Examples:\n        ```\n        &gt;&gt;&gt; table['a']                        selects column 'a'\n        &gt;&gt;&gt; table[3]                          selects row 3 as a tuple.\n        &gt;&gt;&gt; table[:10]                        selects first 10 rows from all columns\n        &gt;&gt;&gt; table['a','b', slice(3,20,2)]     selects a slice from columns 'a' and 'b'\n        &gt;&gt;&gt; table['b', 'a', 'a', 'c', 2:20:3] selects column 'b' and 'c' and 'a' twice for a slice.\n        &gt;&gt;&gt; table[('b', 'a', 'a', 'c')]       selects columns 'b', 'a', 'a', and 'c' using a tuple.\n        ```\n    Raises:\n        KeyError: if key is not found.\n        TypeError: if key is not a string, integer or slice.\n\n    Returns:\n        Table: returns columns in same order as selection.\n    \"\"\"\n\n    if not isinstance(keys, tuple):\n        if isinstance(keys, list):\n            keys = tuple(keys)\n        else:\n            keys = (keys,)\n    if isinstance(keys[0], tuple):\n        keys = tuple(list(chain(*keys)))\n\n    integers = [i for i in keys if isinstance(i, int)]\n    if len(integers) == len(keys) == 1:  # return a single tuple.\n        keys = [slice(keys[0])]\n\n    column_names = [i for i in keys if isinstance(i, str)]\n    column_names = list(self.columns) if not column_names else column_names\n    not_found = [name for name in column_names if name not in self.columns]\n    if not_found:\n        raise KeyError(f\"keys not found: {', '.join(not_found)}\")\n\n    slices = [i for i in keys if isinstance(i, slice)]\n    slc = slice(0, len(self)) if not slices else slices[0]\n\n    if (\n        len(slices) == 0 and len(column_names) == 1\n    ):  # e.g. tbl['a'] or tbl['a'][:10]\n        col = self.columns[column_names[0]]\n        if slices:\n            return col[slc]  # return slice from column as list of values\n        else:\n            return col  # return whole column\n\n    elif len(integers) == 1:  # return a single tuple.\n        row_no = integers[0]\n        slc = slice(row_no, row_no + 1)\n        return tuple(self.columns[name][slc].tolist()[0] for name in column_names)\n\n    elif not slices:  # e.g. new table with N whole columns.\n        return self.__class__(\n            columns={name: self.columns[name] for name in column_names}\n        )\n\n    else:  # e.g. new table from selection of columns and slices.\n        t = self.__class__()\n        for name in column_names:\n            column = self.columns[name]\n\n            new_column = Column(t.path)  # create new Column.\n            for item in column.getpages(slc):\n                if isinstance(item, np.ndarray):\n                    new_column.extend(item)  # extend subslice (expensive)\n                elif isinstance(item, SimplePage):\n                    new_column.pages.append(item)  # extend page (cheap)\n                else:\n                    raise TypeError(f\"Bad item: {item}\")\n\n            # below:\n            # set the new column directly on t.columns.\n            # Do not use t[name] as that triggers __setitem__ again.\n            t.columns[name] = new_column\n\n        return t\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.__len__","title":"<code>tablite.base.BaseTable.__len__()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __len__(self):  # USER FUNCTION.\n    if not self.columns:\n        return 0\n    return max(len(c) for c in self.columns.values())\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.__eq__","title":"<code>tablite.base.BaseTable.__eq__(other) -&gt; bool</code>","text":"<p>Determines if two tables have identical content.</p> PARAMETER  DESCRIPTION <code>other</code> <p>table for comparison</p> <p> TYPE: <code>Table</code> </p> RETURNS DESCRIPTION <code>bool</code> <p>True if tables are identical.</p> <p> TYPE: <code>bool</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def __eq__(self, other) -&gt; bool:  # USER FUNCTION.\n    \"\"\"Determines if two tables have identical content.\n\n    Args:\n        other (Table): table for comparison\n\n    Returns:\n        bool: True if tables are identical.\n    \"\"\"\n    if isinstance(other, dict):\n        return self.items() == other.items()\n    if not isinstance(other, BaseTable):\n        return False\n    if id(self) == id(other):\n        return True\n    if len(self) != len(other):\n        return False\n    if len(self) == len(other) == 0:\n        return True\n    if self.columns.keys() != other.columns.keys():\n        return False\n    for name, col in self.columns.items():\n        if not (col == other.columns[name]):\n            return False\n    return True\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.clear","title":"<code>tablite.base.BaseTable.clear()</code>","text":"<p>clears the table. Like dict().clear()</p> Source code in <code>tablite/base.py</code> <pre><code>def clear(self):  # USER FUNCTION.\n    \"\"\"clears the table. Like dict().clear()\"\"\"\n    self.columns.clear()\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.save","title":"<code>tablite.base.BaseTable.save(path, compression_method=zipfile.ZIP_DEFLATED, compression_level=1)</code>","text":"<p>saves table to compressed tpz file.</p> PARAMETER  DESCRIPTION <code>path</code> <p>file destination.</p> <p> TYPE: <code>Path</code> </p> <code>compression_method</code> <p>See zipfile compression methods. Defaults to ZIP_DEFLATED.</p> <p> DEFAULT: <code>ZIP_DEFLATED</code> </p> <code>compression_level</code> <p>See zipfile compression levels. Defaults to 1.</p> <p> DEFAULT: <code>1</code> </p> <p>The file format is as follows: .tpz is a gzip archive with table metadata captured as table.yml and the necessary set of pages saved as .npy files.</p> <p>The zip contains table.yml which provides an overview of the data:</p> <pre><code>--------------------------------------\n%YAML 1.2                              yaml version\ncolumns:                               start of columns section.\n    name: \u201c\u5217 1\u201d                       name of column 1.\n        pages: [p1b1, p1b2]            list of pages in column 1.\n    name: \u201c\u5217 2\u201d                       name of column 2\n        pages: [p2b1, p2b2]            list of pages in column 2.\n----------------------------------------\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def save(\n    self, path, compression_method=zipfile.ZIP_DEFLATED, compression_level=1\n):  # USER FUNCTION.\n    \"\"\"saves table to compressed tpz file.\n\n    Args:\n        path (Path): file destination.\n        compression_method: See zipfile compression methods. Defaults to ZIP_DEFLATED.\n        compression_level: See zipfile compression levels. Defaults to 1.\n        The default settings produce 80% compression at 10% slowdown.\n\n    The file format is as follows:\n    .tpz is a gzip archive with table metadata captured as table.yml\n    and the necessary set of pages saved as .npy files.\n\n    The zip contains table.yml which provides an overview of the data:\n    ```\n    --------------------------------------\n    %YAML 1.2                              yaml version\n    columns:                               start of columns section.\n        name: \u201c\u5217 1\u201d                       name of column 1.\n            pages: [p1b1, p1b2]            list of pages in column 1.\n        name: \u201c\u5217 2\u201d                       name of column 2\n            pages: [p2b1, p2b2]            list of pages in column 2.\n    ----------------------------------------\n    ```\n    \"\"\"\n    if isinstance(path, str):\n        path = Path(path)\n    type_check(path, Path)\n    if path.is_dir():\n        raise TypeError(f\"filename needed: {path}\")\n    if path.suffix != \".tpz\":\n        path = path.parent / (path.parts[-1] + \".tpz\")\n\n    # create yaml document\n    _page_counter = 0\n    d = {}\n    cols = {}\n    for name, col in self.columns.items():\n        type_check(col, Column)\n        cols[name] = {\"pages\": [p.path.name for p in col.pages]}\n        _page_counter += len(col.pages)\n    d[\"columns\"] = cols\n    yml = yaml.safe_dump(\n        d, sort_keys=False, allow_unicode=True, default_flow_style=None\n    )\n\n    _file_counter = 0\n    with zipfile.ZipFile(\n        path, \"w\", compression=compression_method, compresslevel=compression_level\n    ) as f:\n        log.debug(f\"writing .tpz to {path} with\\n{yml}\")\n        f.writestr(\"table.yml\", yml)\n        for name, col in self.columns.items():\n            for page in set(\n                col.pages\n            ):  # set of pages! remember t *= 1000 repeats t 1000x\n                with open(page.path, \"rb\", buffering=0) as raw_io:\n                    f.writestr(page.path.name, raw_io.read())\n                _file_counter += 1\n                log.debug(f\"adding Page {page.path}\")\n\n        _fields = len(self) * len(self.columns)\n        _avg = _fields // _page_counter\n        log.debug(\n            f\"Wrote {_fields:,} on {_page_counter:,} pages in {_file_counter} files: {_avg} fields/page\"\n        )\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.load","title":"<code>tablite.base.BaseTable.load(path, tqdm=_tqdm)</code>  <code>classmethod</code>","text":"<p>loads a table from .tpz file. See also Table.save for details on the file format.</p> PARAMETER  DESCRIPTION <code>path</code> <p>source file</p> <p> TYPE: <code>Path</code> </p> RETURNS DESCRIPTION <code>Table</code> <p>table in read-only mode.</p> Source code in <code>tablite/base.py</code> <pre><code>@classmethod\ndef load(cls, path, tqdm=_tqdm):  # USER FUNCTION.\n    \"\"\"loads a table from .tpz file.\n    See also Table.save for details on the file format.\n\n    Args:\n        path (Path): source file\n\n    Returns:\n        Table: table in read-only mode.\n    \"\"\"\n    path = Path(path)\n    log.debug(f\"loading {path}\")\n    with zipfile.ZipFile(path, \"r\") as f:\n        yml = f.read(\"table.yml\")\n        metadata = yaml.safe_load(yml)\n        t = cls()\n\n        page_count = sum([len(c[\"pages\"]) for c in metadata[\"columns\"].values()])\n\n        with tqdm(\n            total=page_count,\n            desc=f\"loading '{path.name}' file\",\n            disable=Config.TQDM_DISABLE,\n        ) as pbar:\n            for name, d in metadata[\"columns\"].items():\n                column = Column(t.path)\n                for page in d[\"pages\"]:\n                    bytestream = io.BytesIO(f.read(page))\n                    data = np.load(bytestream, allow_pickle=True, fix_imports=False)\n                    column.extend(data)\n                    pbar.update(1)\n                t.columns[name] = column\n    update_access_time(path)\n    return t\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.copy","title":"<code>tablite.base.BaseTable.copy()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def copy(self):\n    cls = type(self)\n    t = cls()\n    for name, column in self.columns.items():\n        new = Column(t.path)\n        new.pages = column.pages[:]\n        t.columns[name] = new\n    return t\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.__imul__","title":"<code>tablite.base.BaseTable.__imul__(other)</code>","text":"<p>Repeats instance of table N times.</p> <p>Like list: <code>t = t * N</code></p> PARAMETER  DESCRIPTION <code>other</code> <p>multiplier</p> <p> TYPE: <code>int</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def __imul__(self, other):\n    \"\"\"Repeats instance of table N times.\n\n    Like list: `t = t * N`\n\n    Args:\n        other (int): multiplier\n    \"\"\"\n    if not (isinstance(other, int) and other &gt; 0):\n        raise TypeError(\n            f\"a table can be repeated an integer number of times, not {type(other)} number of times\"\n        )\n    for col in self.columns.values():\n        col *= other\n    return self\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.__mul__","title":"<code>tablite.base.BaseTable.__mul__(other)</code>","text":"<p>Repeat table N times. Like list: <code>new = old * N</code></p> PARAMETER  DESCRIPTION <code>other</code> <p>multiplier</p> <p> TYPE: <code>int</code> </p> RETURNS DESCRIPTION <p>Table</p> Source code in <code>tablite/base.py</code> <pre><code>def __mul__(self, other):\n    \"\"\"Repeat table N times.\n    Like list: `new = old * N`\n\n    Args:\n        other (int): multiplier\n\n    Returns:\n        Table\n    \"\"\"\n    new = self.copy()\n    return new.__imul__(other)\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.__iadd__","title":"<code>tablite.base.BaseTable.__iadd__(other)</code>","text":"<p>Concatenates tables with same column names.</p> <p>Like list: <code>table_1 += table_2</code></p> RAISES DESCRIPTION <code>ValueError</code> <p>If column names don't match.</p> RETURNS DESCRIPTION <code>None</code> <p>self is updated.</p> Source code in <code>tablite/base.py</code> <pre><code>def __iadd__(self, other):\n    \"\"\"Concatenates tables with same column names.\n\n    Like list: `table_1 += table_2`\n\n    Args:\n        other (Table)\n\n    Raises:\n        ValueError: If column names don't match.\n\n    Returns:\n        None: self is updated.\n    \"\"\"\n    type_check(other, BaseTable)\n    for name in self.columns.keys():\n        if name not in other.columns:\n            raise ValueError(f\"{name} not in other\")\n    for name in other.columns.keys():\n        if name not in self.columns:\n            raise ValueError(f\"{name} missing from self\")\n\n    for name, column in self.columns.items():\n        other_col = other.columns.get(name, None)\n        column.pages.extend(other_col.pages[:])\n    return self\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.__add__","title":"<code>tablite.base.BaseTable.__add__(other)</code>","text":"<p>Concatenates tables with same column names.</p> <p>Like list: <code>table_3 = table_1 + table_2</code></p> RAISES DESCRIPTION <code>ValueError</code> <p>If column names don't match.</p> RETURNS DESCRIPTION <p>Table</p> Source code in <code>tablite/base.py</code> <pre><code>def __add__(self, other):\n    \"\"\"Concatenates tables with same column names.\n\n    Like list: `table_3 = table_1 + table_2`\n\n    Args:\n        other (Table)\n\n    Raises:\n        ValueError: If column names don't match.\n\n    Returns:\n        Table\n    \"\"\"\n    type_check(other, BaseTable)\n    cp = self.copy()\n    cp += other\n    return cp\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.add_rows","title":"<code>tablite.base.BaseTable.add_rows(*args, **kwargs)</code>","text":"<p>its more efficient to add many rows at once.</p> <p>if both args and kwargs, then args are added first, followed by kwargs.</p> <p>supported cases:</p> <pre><code>&gt;&gt;&gt; t = Table()\n&gt;&gt;&gt; t.add_columns('row','A','B','C')\n&gt;&gt;&gt; t.add_rows(1, 1, 2, 3)                              # (1) individual values as args\n&gt;&gt;&gt; t.add_rows([2, 1, 2, 3])                            # (2) list of values as args\n&gt;&gt;&gt; t.add_rows((3, 1, 2, 3))                            # (3) tuple of values as args\n&gt;&gt;&gt; t.add_rows(*(4, 1, 2, 3))                           # (4) unpacked tuple becomes arg like (1)\n&gt;&gt;&gt; t.add_rows(row=5, A=1, B=2, C=3)                    # (5) kwargs\n&gt;&gt;&gt; t.add_rows(**{'row': 6, 'A': 1, 'B': 2, 'C': 3})    # (6) dict / json interpreted a kwargs\n&gt;&gt;&gt; t.add_rows((7, 1, 2, 3), (8, 4, 5, 6))              # (7) two (or more) tuples as args\n&gt;&gt;&gt; t.add_rows([9, 1, 2, 3], [10, 4, 5, 6])             # (8) two or more lists as rgs\n&gt;&gt;&gt; t.add_rows(\n    {'row': 11, 'A': 1, 'B': 2, 'C': 3},\n    {'row': 12, 'A': 4, 'B': 5, 'C': 6}\n    )                                                   # (9) two (or more) dicts as args - roughly comma sep'd json.\n&gt;&gt;&gt; t.add_rows( *[\n    {'row': 13, 'A': 1, 'B': 2, 'C': 3},\n    {'row': 14, 'A': 1, 'B': 2, 'C': 3}\n    ])                                                  # (10) list of dicts as args\n&gt;&gt;&gt; t.add_rows(row=[15,16], A=[1,1], B=[2,2], C=[3,3])  # (11) kwargs with lists as values\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def add_rows(self, *args, **kwargs):\n    \"\"\"its more efficient to add many rows at once.\n\n    if both args and kwargs, then args are added first, followed by kwargs.\n\n    supported cases:\n    ```\n    &gt;&gt;&gt; t = Table()\n    &gt;&gt;&gt; t.add_columns('row','A','B','C')\n    &gt;&gt;&gt; t.add_rows(1, 1, 2, 3)                              # (1) individual values as args\n    &gt;&gt;&gt; t.add_rows([2, 1, 2, 3])                            # (2) list of values as args\n    &gt;&gt;&gt; t.add_rows((3, 1, 2, 3))                            # (3) tuple of values as args\n    &gt;&gt;&gt; t.add_rows(*(4, 1, 2, 3))                           # (4) unpacked tuple becomes arg like (1)\n    &gt;&gt;&gt; t.add_rows(row=5, A=1, B=2, C=3)                    # (5) kwargs\n    &gt;&gt;&gt; t.add_rows(**{'row': 6, 'A': 1, 'B': 2, 'C': 3})    # (6) dict / json interpreted a kwargs\n    &gt;&gt;&gt; t.add_rows((7, 1, 2, 3), (8, 4, 5, 6))              # (7) two (or more) tuples as args\n    &gt;&gt;&gt; t.add_rows([9, 1, 2, 3], [10, 4, 5, 6])             # (8) two or more lists as rgs\n    &gt;&gt;&gt; t.add_rows(\n        {'row': 11, 'A': 1, 'B': 2, 'C': 3},\n        {'row': 12, 'A': 4, 'B': 5, 'C': 6}\n        )                                                   # (9) two (or more) dicts as args - roughly comma sep'd json.\n    &gt;&gt;&gt; t.add_rows( *[\n        {'row': 13, 'A': 1, 'B': 2, 'C': 3},\n        {'row': 14, 'A': 1, 'B': 2, 'C': 3}\n        ])                                                  # (10) list of dicts as args\n    &gt;&gt;&gt; t.add_rows(row=[15,16], A=[1,1], B=[2,2], C=[3,3])  # (11) kwargs with lists as values\n    ```\n\n    \"\"\"\n    if not BaseTable._add_row_slow_warning:\n        warnings.warn(\n            \"add_rows is slow. Consider using add_columns and then assigning values to the columns directly.\"\n        )\n        BaseTable._add_row_slow_warning = True\n\n    if args:\n        if not all(isinstance(i, (list, tuple, dict)) for i in args):  # 1,4\n            args = [args]\n\n        if all(isinstance(i, (list, tuple, dict)) for i in args):  # 2,3,7,8\n            # 1. turn the data into columns:\n\n            d = {n: [] for n in self.columns}\n            for arg in args:\n                if len(arg) != len(self.columns):\n                    raise ValueError(\n                        f\"len({arg})== {len(arg)}, but there are {len(self.columns)} columns\"\n                    )\n\n                if isinstance(arg, dict):\n                    for k, v in arg.items():  # 7,8\n                        d[k].append(v)\n\n                elif isinstance(arg, (list, tuple)):  # 2,3\n                    for n, v in zip(self.columns, arg):\n                        d[n].append(v)\n\n                else:\n                    raise TypeError(f\"{arg}?\")\n            # 2. extend the columns\n            for n, values in d.items():\n                col = self.columns[n]\n                col.extend(list_to_np_array(values))\n\n    if kwargs:\n        if isinstance(kwargs, dict):\n            if all(isinstance(v, (list, tuple)) for v in kwargs.values()):\n                for k, v in kwargs.items():\n                    col = self.columns[k]\n                    col.extend(list_to_np_array(v))\n            else:\n                for k, v in kwargs.items():\n                    col = self.columns[k]\n                    col.extend(np.array([v]))\n        else:\n            raise ValueError(f\"format not recognised: {kwargs}\")\n\n    return\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.add_columns","title":"<code>tablite.base.BaseTable.add_columns(*names)</code>","text":"<p>Adds column names to table.</p> Source code in <code>tablite/base.py</code> <pre><code>def add_columns(self, *names):\n    \"\"\"Adds column names to table.\"\"\"\n    for name in names:\n        self.columns[name] = Column(self.path)\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.add_column","title":"<code>tablite.base.BaseTable.add_column(name, data=None)</code>","text":"<p>verbose alias for table[name] = data, that checks if name already exists</p> PARAMETER  DESCRIPTION <code>name</code> <p>column name</p> <p> TYPE: <code>str</code> </p> <code>data</code> <p>values. Defaults to None.</p> <p> TYPE: <code>list,tuple)</code> DEFAULT: <code>None</code> </p> RAISES DESCRIPTION <code>TypeError</code> <p>name isn't string</p> <code>ValueError</code> <p>name already exists</p> Source code in <code>tablite/base.py</code> <pre><code>def add_column(self, name, data=None):\n    \"\"\"verbose alias for table[name] = data, that checks if name already exists\n\n    Args:\n        name (str): column name\n        data ((list,tuple), optional): values. Defaults to None.\n\n    Raises:\n        TypeError: name isn't string\n        ValueError: name already exists\n    \"\"\"\n    if not isinstance(name, str):\n        raise TypeError(\"expected name as string\")\n    if name in self.columns:\n        raise ValueError(f\"{name} already in {self.columns}\")\n    self.__setitem__(name, data)\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.stack","title":"<code>tablite.base.BaseTable.stack(other)</code>","text":"<p>returns the joint stack of tables with overlapping column names. Example:</p> <pre><code>| Table A|  +  | Table B| = |  Table AB |\n| A| B| C|     | A| B| D|   | A| B| C| -|\n                            | A| B| -| D|\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def stack(self, other):\n    \"\"\"\n    returns the joint stack of tables with overlapping column names.\n    Example:\n    ```\n    | Table A|  +  | Table B| = |  Table AB |\n    | A| B| C|     | A| B| D|   | A| B| C| -|\n                                | A| B| -| D|\n    ```\n    \"\"\"\n    if not isinstance(other, BaseTable):\n        raise TypeError(f\"stack only works for Table, not {type(other)}\")\n\n    cp = self.copy()\n    for name, col2 in other.columns.items():\n        if name not in cp.columns:\n            cp[name] = [None] * len(self)\n        cp[name].pages.extend(col2.pages[:])\n\n    for name in self.columns:\n        if name not in other.columns:\n            if len(cp) &gt; 0:\n                cp[name].extend(np.array([None] * len(other)))\n    return cp\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.types","title":"<code>tablite.base.BaseTable.types()</code>","text":"<p>returns nested dict of data types in the form: <code>{column name: {python type class: number of instances }, ... }</code></p> <p>example:</p> <pre><code>&gt;&gt;&gt; t.types()\n{\n    'A': {&lt;class 'str'&gt;: 7},\n    'B': {&lt;class 'int'&gt;: 7}\n}\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def types(self):\n    \"\"\"\n    returns nested dict of data types in the form:\n    `{column name: {python type class: number of instances }, ... }`\n\n    example:\n    ```\n    &gt;&gt;&gt; t.types()\n    {\n        'A': {&lt;class 'str'&gt;: 7},\n        'B': {&lt;class 'int'&gt;: 7}\n    }\n    ```\n    \"\"\"\n    d = {}\n    for name, col in self.columns.items():\n        assert isinstance(col, Column)\n        d[name] = col.types()\n    return d\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.display_dict","title":"<code>tablite.base.BaseTable.display_dict(slice_=None, blanks=None, dtype=False)</code>","text":"<p>helper for creating dict for display.</p> PARAMETER  DESCRIPTION <code>slice_</code> <p>python slice. Defaults to None.</p> <p> TYPE: <code>slice</code> DEFAULT: <code>None</code> </p> <code>blanks</code> <p>fill value for <code>None</code>. Defaults to None.</p> <p> TYPE: <code>optional</code> DEFAULT: <code>None</code> </p> <code>dtype</code> <p>Adds datatype to each column. Defaults to False.</p> <p> TYPE: <code>bool</code> DEFAULT: <code>False</code> </p> RAISES DESCRIPTION <code>TypeError</code> <p>slice_ must be None or slice.</p> RETURNS DESCRIPTION <code>dict</code> <p>from Table.</p> Source code in <code>tablite/base.py</code> <pre><code>def display_dict(self, slice_=None, blanks=None, dtype=False):\n    \"\"\"helper for creating dict for display.\n\n    Args:\n        slice_ (slice, optional): python slice. Defaults to None.\n        blanks (optional): fill value for `None`. Defaults to None.\n        dtype (bool, optional): Adds datatype to each column. Defaults to False.\n\n    Raises:\n        TypeError: slice_ must be None or slice.\n\n    Returns:\n        dict: from Table.\n    \"\"\"\n    if not self.columns:\n        print(\"Empty Table\")\n        return\n\n    def datatype(col):  # PRIVATE\n        \"\"\"creates label for column datatype.\"\"\"\n        types = col.types()\n        if len(types) == 0:\n            typ = \"empty\"\n        elif len(types) == 1:\n            dt, _ = types.popitem()\n            typ = dt.__name__\n        else:\n            typ = \"mixed\"\n        return typ\n\n    row_count_tags = [\"#\", \"~\", \"*\"]\n    cols = set(self.columns)\n    for n, tag in product(range(1, 6), row_count_tags):\n        if n * tag not in cols:\n            tag = n * tag\n            break\n\n    if not isinstance(slice_, (slice, type(None))):\n        raise TypeError(f\"slice_ must be None or slice, not {type(slice_)}\")\n    if isinstance(slice_, slice):\n        slc = slice_\n    if slice_ is None:\n        if len(self) &lt;= 20:\n            slc = slice(0, 20, 1)\n        else:\n            slc = None\n\n    n = len(self)\n    if slc:  # either we want slc or we want everything.\n        row_no = list(range(*slc.indices(len(self))))\n        data = {tag: [f\"{i:,}\".rjust(2) for i in row_no]}\n        for name, col in self.columns.items():\n            data[name] = list(chain(iter(col), repeat(blanks, times=n - len(col))))[\n                slc\n            ]\n    else:\n        data = {}\n        j = int(math.ceil(math.log10(n)) / 3) + len(str(n))\n        row_no = (\n            [f\"{i:,}\".rjust(j) for i in range(7)]\n            + [\"...\"]\n            + [f\"{i:,}\".rjust(j) for i in range(n - 7, n)]\n        )\n        data = {tag: row_no}\n\n        for name, col in self.columns.items():\n            if len(col) == n:\n                row = col[:7].tolist() + [\"...\"] + col[-7:].tolist()\n            else:\n                empty = [blanks] * 7\n                head = (col[:7].tolist() + empty)[:7]\n                tail = (col[n - 7 :].tolist() + empty)[-7:]\n                row = head + [\"...\"] + tail\n            data[name] = row\n\n    if dtype:\n        for name, values in data.items():\n            if name in self.columns:\n                col = self.columns[name]\n                values.insert(0, datatype(col))\n            else:\n                values.insert(0, \"row\")\n\n    return data\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.to_ascii","title":"<code>tablite.base.BaseTable.to_ascii(slice_=None, blanks=None, dtype=False)</code>","text":"<p>returns ascii view of table as string.</p> PARAMETER  DESCRIPTION <code>slice_</code> <p>slice to determine table snippet.</p> <p> TYPE: <code>slice</code> DEFAULT: <code>None</code> </p> <code>blanks</code> <p>value for whitespace. Defaults to None.</p> <p> TYPE: <code>str</code> DEFAULT: <code>None</code> </p> <code>dtype</code> <p>adds subheader with datatype for column. Defaults to False.</p> <p> TYPE: <code>bool</code> DEFAULT: <code>False</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def to_ascii(self, slice_=None, blanks=None, dtype=False):\n    \"\"\"returns ascii view of table as string.\n\n    Args:\n        slice_ (slice, optional): slice to determine table snippet.\n        blanks (str, optional): value for whitespace. Defaults to None.\n        dtype (bool, optional): adds subheader with datatype for column. Defaults to False.\n    \"\"\"\n\n    def adjust(v, length):  # PRIVATE FUNCTION\n        \"\"\"whitespace justifies field values based on datatype\"\"\"\n        if v is None:\n            return str(blanks).ljust(length)\n        elif isinstance(v, str):\n            return v.ljust(length)\n        else:\n            return str(v).rjust(length)\n\n    if not self.columns:\n        return str(self)\n\n    d = {}\n    for name, values in self.display_dict(\n        slice_=slice_, blanks=blanks, dtype=dtype\n    ).items():\n        as_text = [str(v) for v in values] + [str(name)]\n        width = max(len(i) for i in as_text)\n        new_name = name.center(width, \" \")\n        if dtype:\n            values[0] = values[0].center(width, \" \")\n        d[new_name] = [adjust(v, width) for v in values]\n\n    rows = dict_to_rows(d)\n    s = []\n    s.append(\"+\" + \"+\".join([\"=\" * len(n) for n in rows[0]]) + \"+\")\n    s.append(\"|\" + \"|\".join(rows[0]) + \"|\")  # column names\n    start = 1\n    if dtype:\n        s.append(\"|\" + \"|\".join(rows[1]) + \"|\")  # datatypes\n        start = 2\n\n    s.append(\"+\" + \"+\".join([\"-\" * len(n) for n in rows[0]]) + \"+\")\n    for row in rows[start:]:\n        s.append(\"|\" + \"|\".join(row) + \"|\")\n    s.append(\"+\" + \"+\".join([\"=\" * len(n) for n in rows[0]]) + \"+\")\n\n    if len(set(len(c) for c in self.columns.values())) != 1:\n        warning = f\"Warning: Columns have different lengths. {blanks} is used as fill value.\"\n        s.append(warning)\n\n    return \"\\n\".join(s)\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.show","title":"<code>tablite.base.BaseTable.show(slice_=None, blanks=None, dtype=False)</code>","text":"<p>prints ascii view of table.</p> PARAMETER  DESCRIPTION <code>slice_</code> <p>slice to determine table snippet.</p> <p> TYPE: <code>slice</code> DEFAULT: <code>None</code> </p> <code>blanks</code> <p>value for whitespace. Defaults to None.</p> <p> TYPE: <code>str</code> DEFAULT: <code>None</code> </p> <code>dtype</code> <p>adds subheader with datatype for column. Defaults to False.</p> <p> TYPE: <code>bool</code> DEFAULT: <code>False</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def show(self, slice_=None, blanks=None, dtype=False):\n    \"\"\"prints ascii view of table.\n\n    Args:\n        slice_ (slice, optional): slice to determine table snippet.\n        blanks (str, optional): value for whitespace. Defaults to None.\n        dtype (bool, optional): adds subheader with datatype for column. Defaults to False.\n    \"\"\"\n    print(self.to_ascii(slice_=slice_, blanks=blanks, dtype=dtype))\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.to_dict","title":"<code>tablite.base.BaseTable.to_dict(columns=None, slice_=None)</code>","text":"<p>columns: list of column names. Default is None == all columns. slice_: slice. Default is None == all rows.</p> <p>returns: dict with columns as keys and lists of values.</p> <p>Example:</p> <pre><code>&gt;&gt;&gt; t.show()\n+===+===+===+\n| # | a | b |\n|row|int|int|\n+---+---+---+\n| 0 |  1|  3|\n| 1 |  2|  4|\n+===+===+===+\n&gt;&gt;&gt; t.to_dict()\n{'a':[1,2], 'b':[3,4]}\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def to_dict(self, columns=None, slice_=None):\n    \"\"\"\n    columns: list of column names. Default is None == all columns.\n    slice_: slice. Default is None == all rows.\n\n    returns: dict with columns as keys and lists of values.\n\n    Example:\n    ```\n    &gt;&gt;&gt; t.show()\n    +===+===+===+\n    | # | a | b |\n    |row|int|int|\n    +---+---+---+\n    | 0 |  1|  3|\n    | 1 |  2|  4|\n    +===+===+===+\n    &gt;&gt;&gt; t.to_dict()\n    {'a':[1,2], 'b':[3,4]}\n    ```\n\n    \"\"\"\n    if slice_ is None:\n        slice_ = slice(0, len(self))\n    assert isinstance(slice_, slice)\n\n    if columns is None:\n        columns = list(self.columns.keys())\n    if not isinstance(columns, list):\n        raise TypeError(\"expected columns as list of strings\")\n\n    return {name: list(self.columns[name][slice_]) for name in columns}\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.as_json_serializable","title":"<code>tablite.base.BaseTable.as_json_serializable(row_count='row id', start_on=1, columns=None, slice_=None)</code>","text":"<p>provides a JSON compatible format of the table.</p> PARAMETER  DESCRIPTION <code>row_count</code> <p>Label for row counts. Defaults to \"row id\".</p> <p> TYPE: <code>str</code> DEFAULT: <code>'row id'</code> </p> <code>start_on</code> <p>row counts starts by default on 1.</p> <p> TYPE: <code>int</code> DEFAULT: <code>1</code> </p> <code>columns</code> <p>Column names. Defaults to None which returns all columns.</p> <p> TYPE: <code>list of str</code> DEFAULT: <code>None</code> </p> <code>slice_</code> <p>selector. Defaults to None which returns [:]</p> <p> TYPE: <code>slice</code> DEFAULT: <code>None</code> </p> RETURNS DESCRIPTION <p>JSON serializable dict: All python datatypes have been converted to JSON compliant data.</p> Source code in <code>tablite/base.py</code> <pre><code>def as_json_serializable(\n    self, row_count=\"row id\", start_on=1, columns=None, slice_=None\n):\n    \"\"\"provides a JSON compatible format of the table.\n\n    Args:\n        row_count (str, optional): Label for row counts. Defaults to \"row id\".\n        start_on (int, optional): row counts starts by default on 1.\n        columns (list of str, optional): Column names.\n            Defaults to None which returns all columns.\n        slice_ (slice, optional): selector. Defaults to None which returns [:]\n\n    Returns:\n        JSON serializable dict: All python datatypes have been converted to JSON compliant data.\n    \"\"\"\n    if slice_ is None:\n        slice_ = slice(0, len(self))\n\n    assert isinstance(slice_, slice)\n    new = {\"columns\": {}, \"total_rows\": len(self)}\n    if row_count is not None:\n        new[\"columns\"][row_count] = [\n            i + start_on for i in range(*slice_.indices(len(self)))\n        ]\n\n    d = self.to_dict(columns, slice_=slice_)\n    for k, data in d.items():\n        new_k = unique_name(\n            k, new[\"columns\"]\n        )  # used to avoid overwriting the `row id` key.\n        new[\"columns\"][new_k] = [\n            DataTypes.to_json(v) for v in data\n        ]  # deal with non-json datatypes.\n    return new\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.index","title":"<code>tablite.base.BaseTable.index(*args)</code>","text":"<p>param: *args: column names returns multikey index on the columns as d[(key tuple, )] = {index1, index2, ...}</p> <p>Examples:</p> <pre><code>&gt;&gt;&gt; table6 = Table()\n&gt;&gt;&gt; table6['A'] = ['Alice', 'Bob', 'Bob', 'Ben', 'Charlie', 'Ben','Albert']\n&gt;&gt;&gt; table6['B'] = ['Alison', 'Marley', 'Dylan', 'Affleck', 'Hepburn', 'Barnes', 'Einstein']\n</code></pre> <pre><code>&gt;&gt;&gt; table6.index('A')  # single key.\n{('Alice',): [0],\n ('Bob',): [1, 2],\n ('Ben',): [3, 5],\n ('Charlie',): [4],\n ('Albert',): [6]})\n</code></pre> <pre><code>&gt;&gt;&gt; table6.index('A', 'B')  # multiple keys.\n{('Alice', 'Alison'): [0],\n ('Bob', 'Marley'): [1],\n ('Bob', 'Dylan'): [2],\n ('Ben', 'Affleck'): [3],\n ('Charlie', 'Hepburn'): [4],\n ('Ben', 'Barnes'): [5],\n ('Albert', 'Einstein'): [6]})\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def index(self, *args):\n    \"\"\"\n    param: *args: column names\n    returns multikey index on the columns as d[(key tuple, )] = {index1, index2, ...}\n\n    Examples:\n        ```\n        &gt;&gt;&gt; table6 = Table()\n        &gt;&gt;&gt; table6['A'] = ['Alice', 'Bob', 'Bob', 'Ben', 'Charlie', 'Ben','Albert']\n        &gt;&gt;&gt; table6['B'] = ['Alison', 'Marley', 'Dylan', 'Affleck', 'Hepburn', 'Barnes', 'Einstein']\n        ```\n\n        ```\n        &gt;&gt;&gt; table6.index('A')  # single key.\n        {('Alice',): [0],\n         ('Bob',): [1, 2],\n         ('Ben',): [3, 5],\n         ('Charlie',): [4],\n         ('Albert',): [6]})\n        ```\n\n        ```\n        &gt;&gt;&gt; table6.index('A', 'B')  # multiple keys.\n        {('Alice', 'Alison'): [0],\n         ('Bob', 'Marley'): [1],\n         ('Bob', 'Dylan'): [2],\n         ('Ben', 'Affleck'): [3],\n         ('Charlie', 'Hepburn'): [4],\n         ('Ben', 'Barnes'): [5],\n         ('Albert', 'Einstein'): [6]})\n        ```\n\n    \"\"\"\n    idx = defaultdict(list)\n    iterators = [iter(self.columns[c]) for c in args]\n    for ix, key in enumerate(zip(*iterators)):\n        key = tuple(numpy_to_python(k) for k in key)\n        idx[key].append(ix)\n    return idx\n</code></pre>"},{"location":"reference/base/#tablite.base.BaseTable.unique_index","title":"<code>tablite.base.BaseTable.unique_index(*args, tqdm=_tqdm)</code>","text":"<p>generates the index of unique rows given a list of column names</p> PARAMETER  DESCRIPTION <code>*args</code> <p>columns names</p> <p> TYPE: <code>any</code> DEFAULT: <code>()</code> </p> <code>tqdm</code> <p>Defaults to _tqdm.</p> <p> TYPE: <code>tqdm</code> DEFAULT: <code>tqdm</code> </p> RETURNS DESCRIPTION <p>np.array(int64): indices of unique records.</p> Source code in <code>tablite/base.py</code> <pre><code>def unique_index(self, *args, tqdm=_tqdm):\n    \"\"\"generates the index of unique rows given a list of column names\n\n    Args:\n        *args (any): columns names\n        tqdm (tqdm, optional): Defaults to _tqdm.\n\n    Returns:\n        np.array(int64): indices of unique records.\n    \"\"\"\n    if not args:\n        raise ValueError(\"*args (column names) is required\")\n    seen = set()\n    unique = set()\n    iterators = [iter(self.columns[c]) for c in args]\n    for ix, key in tqdm(enumerate(zip(*iterators)), disable=Config.TQDM_DISABLE):\n        key_hash = hash(tuple(numpy_to_python(k) for k in key))\n        if key_hash in seen:\n            continue\n        else:\n            seen.add(key_hash)\n            unique.add(ix)\n    return np.array(sorted(unique))\n</code></pre>"},{"location":"reference/base/#tablite.base-functions","title":"Functions","text":""},{"location":"reference/base/#tablite.base.register","title":"<code>tablite.base.register(path)</code>","text":"<p>registers path in file_registry</p> <p>The method is used by Table during init when the working directory path is set, so that python can clean all temporary files up at exit.</p> PARAMETER  DESCRIPTION <code>path</code> <p>typically tmp/tablite-tmp/PID-{os.getpid()}</p> <p> TYPE: <code>Path</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def register(path):\n    \"\"\"registers path in file_registry\n\n    The method is used by Table during init when the working directory path\n    is set, so that python can clean all temporary files up at exit.\n\n    Args:\n        path (Path): typically tmp/tablite-tmp/PID-{os.getpid()}\n    \"\"\"\n    global file_registry\n    file_registry.add(path)\n</code></pre>"},{"location":"reference/base/#tablite.base.shutdown","title":"<code>tablite.base.shutdown()</code>","text":"<p>method to clean up temporary files triggered at shutdown.</p> Source code in <code>tablite/base.py</code> <pre><code>def shutdown():\n    \"\"\"method to clean up temporary files triggered at shutdown.\"\"\"\n    for path in file_registry:\n        if Config.pid in str(path):  # safety feature to prevent rm -rf /\n            log.debug(f\"shutdown: running rmtree({path})\")\n            shutil.rmtree(path)\n</code></pre>"},{"location":"reference/config/","title":"Config","text":""},{"location":"reference/config/#tablite.config","title":"<code>tablite.config</code>","text":""},{"location":"reference/config/#tablite.config-classes","title":"Classes","text":""},{"location":"reference/config/#tablite.config.Config","title":"<code>tablite.config.Config</code>","text":"<p>             Bases: <code>object</code></p> <p>Config class for Tablite Tables.</p> <p>The default location for the storage is loaded as</p> <pre><code>Config.workdir = pathlib.Path(os.environ.get(\"TABLITE_TMPDIR\", f\"{tempfile.gettempdir()}/tablite-tmp\"))\n</code></pre> <p>to overwrite, first import the config class, then set the new workdir.</p> <pre><code>&gt;&gt;&gt; from tablite import config\n&gt;&gt;&gt; from pathlib import Path\n&gt;&gt;&gt; config.workdir = Path(\"/this/new/location\")\n</code></pre> <p>the new path will now be used for every new table.</p> <p>PAGE_SIZE = 1_000_000 sets the page size limit.</p> <p>Multiprocessing is enabled in one of three modes: AUTO = \"auto\" FALSE = \"sp\" FORCE = \"mp\"</p> <p>MULTIPROCESSING_MODE = AUTO  is default.</p> <p>SINGLE_PROCESSING_LIMIT = 1_000_000 when the number of fields (rows x columns) exceed this value, multiprocessing is used.</p>"},{"location":"reference/config/#tablite.config.Config-attributes","title":"Attributes","text":""},{"location":"reference/config/#tablite.config.Config.USE_NIMPORTER","title":"<code>tablite.config.Config.USE_NIMPORTER = os.environ.get('USE_NIMPORTER', 'true').lower() in ['1', 't', 'true', 'y', 'yes']</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.ALLOW_CSV_READER_FALLTHROUGH","title":"<code>tablite.config.Config.ALLOW_CSV_READER_FALLTHROUGH = os.environ.get('ALLOW_CSV_READER_FALLTHROUGH', 'true').lower() in ['1', 't', 'true', 'y', 'yes']</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.NIM_SUPPORTED_CONV_TYPES","title":"<code>tablite.config.Config.NIM_SUPPORTED_CONV_TYPES = ['Windows-1252', 'ISO-8859-1']</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.workdir","title":"<code>tablite.config.Config.workdir = pathlib.Path(os.environ.get('TABLITE_TMPDIR', f'{tempfile.gettempdir()}/tablite-tmp'))</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.pid","title":"<code>tablite.config.Config.pid = f'pid-{os.getpid()}'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.PAGE_SIZE","title":"<code>tablite.config.Config.PAGE_SIZE = 1000000</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.ENCODING","title":"<code>tablite.config.Config.ENCODING = 'UTF-8'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.DISK_LIMIT","title":"<code>tablite.config.Config.DISK_LIMIT = int(10000000000.0)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":"<p>10e9 (10Gb) on 100 Gb disk means raise at 90 Gb disk usage. if DISK_LIMIT &lt;= 0, the check is turned off.</p>"},{"location":"reference/config/#tablite.config.Config.SINGLE_PROCESSING_LIMIT","title":"<code>tablite.config.Config.SINGLE_PROCESSING_LIMIT = 1000000</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":"<p>when the number of fields (rows x columns) exceed this value, multiprocessing is used.</p>"},{"location":"reference/config/#tablite.config.Config.vpus","title":"<code>tablite.config.Config.vpus = max(os.cpu_count() - 1, 1)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.AUTO","title":"<code>tablite.config.Config.AUTO = 'auto'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.FALSE","title":"<code>tablite.config.Config.FALSE = 'sp'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.FORCE","title":"<code>tablite.config.Config.FORCE = 'mp'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.MULTIPROCESSING_MODE","title":"<code>tablite.config.Config.MULTIPROCESSING_MODE = AUTO</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config.TQDM_DISABLE","title":"<code>tablite.config.Config.TQDM_DISABLE = False</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/config/#tablite.config.Config-functions","title":"Functions","text":""},{"location":"reference/config/#tablite.config.Config.reset","title":"<code>tablite.config.Config.reset()</code>  <code>classmethod</code>","text":"<p>Resets the config class to original values.</p> Source code in <code>tablite/config.py</code> <pre><code>@classmethod\ndef reset(cls):\n    \"\"\"Resets the config class to original values.\"\"\"\n    for k, v in _default_values.items():\n        setattr(Config, k, v)\n</code></pre>"},{"location":"reference/config/#tablite.config.Config.page_steps","title":"<code>tablite.config.Config.page_steps(length)</code>  <code>classmethod</code>","text":"<p>an iterator that yield start and end in page sizes</p> YIELDS DESCRIPTION <code>tuple</code> <p>start:int, end:int</p> Source code in <code>tablite/config.py</code> <pre><code>@classmethod\ndef page_steps(cls, length):\n    \"\"\"an iterator that yield start and end in page sizes\n\n    Yields:\n        tuple: start:int, end:int\n    \"\"\"\n    start, end = 0, 0\n    for _ in range(0, length + 1, cls.PAGE_SIZE):\n        start, end = end, min(end + cls.PAGE_SIZE, length)\n        yield start, end\n        if end == length:\n            return\n</code></pre>"},{"location":"reference/core/","title":"Core","text":""},{"location":"reference/core/#tablite.core","title":"<code>tablite.core</code>","text":""},{"location":"reference/core/#tablite.core-attributes","title":"Attributes","text":""},{"location":"reference/core/#tablite.core.log","title":"<code>tablite.core.log = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/core/#tablite.core-classes","title":"Classes","text":""},{"location":"reference/core/#tablite.core.Table","title":"<code>tablite.core.Table(columns=None, headers=None, rows=None, _path=None)</code>","text":"<p>             Bases: <code>BaseTable</code></p> <p>creates Table</p> PARAMETER  DESCRIPTION <code>EITHER</code> <p>columns (dict, optional): dict with column names as keys, values as lists. Example: t = Table(columns={\"a\": [1, 2], \"b\": [3, 4]})</p> <p> </p> Source code in <code>tablite/core.py</code> <pre><code>def __init__(self, columns=None, headers=None, rows=None, _path=None) -&gt; None:\n    \"\"\"creates Table\n\n    Args:\n        EITHER:\n            columns (dict, optional): dict with column names as keys, values as lists.\n            Example: t = Table(columns={\"a\": [1, 2], \"b\": [3, 4]})\n        OR\n            headers (list of strings, optional): list of column names.\n            rows (list of tuples or lists, optional): values for columns\n            Example: t = Table(headers=[\"a\", \"b\"], rows=[[1,3], [2,4]])\n    \"\"\"\n    super().__init__(columns, headers, rows, _path)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table-attributes","title":"Attributes","text":""},{"location":"reference/core/#tablite.core.Table.path","title":"<code>tablite.core.Table.path = _path</code>  <code>instance-attribute</code>","text":""},{"location":"reference/core/#tablite.core.Table.columns","title":"<code>tablite.core.Table.columns = {}</code>  <code>instance-attribute</code>","text":""},{"location":"reference/core/#tablite.core.Table.rows","title":"<code>tablite.core.Table.rows</code>  <code>property</code>","text":"<p>enables row based iteration in python types.</p> <p>Example:</p> <pre><code>for row in Table.rows:\n    print(row)\n</code></pre> <p>Yields:     tuple: values is same order as columns.</p>"},{"location":"reference/core/#tablite.core.Table-functions","title":"Functions","text":""},{"location":"reference/core/#tablite.core.Table.__str__","title":"<code>tablite.core.Table.__str__()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __str__(self):  # USER FUNCTION.\n    return f\"{self.__class__.__name__}({len(self.columns):,} columns, {len(self):,} rows)\"\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.__repr__","title":"<code>tablite.core.Table.__repr__()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __repr__(self):\n    return self.__str__()\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.nbytes","title":"<code>tablite.core.Table.nbytes()</code>","text":"<p>finds the total bytes of the table on disk</p> RETURNS DESCRIPTION <code>tuple</code> <p>int: real bytes used on disk int: total bytes used if flattened</p> Source code in <code>tablite/base.py</code> <pre><code>def nbytes(self):  # USER FUNCTION.\n    \"\"\"finds the total bytes of the table on disk\n\n    Returns:\n        tuple:\n            int: real bytes used on disk\n            int: total bytes used if flattened\n    \"\"\"\n    real = {}\n    total = 0\n    for column in self.columns.values():\n        for page in set(column.pages):\n            real[page] = page.path.stat().st_size\n        for page in column.pages:\n            total += real[page]\n    return sum(real.values()), total\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.items","title":"<code>tablite.core.Table.items()</code>","text":"<p>returns table as dict</p> RETURNS DESCRIPTION <code>dict</code> <p>Table as dict <code>{column_name: [values], ...}</code></p> Source code in <code>tablite/base.py</code> <pre><code>def items(self):  # USER FUNCTION.\n    \"\"\"returns table as dict\n\n    Returns:\n        dict: Table as dict `{column_name: [values], ...}`\n    \"\"\"\n    return {\n        name: column[:].tolist() for name, column in self.columns.items()\n    }.items()\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.__delitem__","title":"<code>tablite.core.Table.__delitem__(key)</code>","text":"<p>Examples:</p> <pre><code>&gt;&gt;&gt; del table['a']  # removes column 'a'\n&gt;&gt;&gt; del table[-3:]  # removes last 3 rows from all columns.\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def __delitem__(self, key):  # USER FUNCTION.\n    \"\"\"\n    Examples:\n    ```\n    &gt;&gt;&gt; del table['a']  # removes column 'a'\n    &gt;&gt;&gt; del table[-3:]  # removes last 3 rows from all columns.\n    ```\n    \"\"\"\n    if isinstance(key, (int, slice)):\n        for column in self.columns.values():\n            del column[key]\n    elif key in self.columns:\n        del self.columns[key]\n    else:\n        raise KeyError(f\"Key not found: {key}\")\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.__setitem__","title":"<code>tablite.core.Table.__setitem__(key, value)</code>","text":"<p>table behaves like a dict. Args:     key (str or hashable): column name     value (iterable): list, tuple or nd.array with values.</p> <p>As Table now accepts the keyword <code>columns</code> as a dict:</p> <pre><code>&gt;&gt;&gt; t = Table(columns={'b':[4,5,6], 'c':[7,8,9]})\n</code></pre> <p>and the header/data combinations:</p> <pre><code>&gt;&gt;&gt; t = Table(header=['b','c'], data=[[4,5,6],[7,8,9]])\n</code></pre> <p>This has the side-benefit that tuples now can be used as headers.</p> Source code in <code>tablite/base.py</code> <pre><code>def __setitem__(self, key, value):  # USER FUNCTION\n    \"\"\"table behaves like a dict.\n    Args:\n        key (str or hashable): column name\n        value (iterable): list, tuple or nd.array with values.\n\n    As Table now accepts the keyword `columns` as a dict:\n    ```\n    &gt;&gt;&gt; t = Table(columns={'b':[4,5,6], 'c':[7,8,9]})\n    ```\n    and the header/data combinations:\n    ```\n    &gt;&gt;&gt; t = Table(header=['b','c'], data=[[4,5,6],[7,8,9]])\n    ```\n    This has the side-benefit that tuples now can be used as headers.\n    \"\"\"\n    if value is None:\n        self.columns[key] = Column(self.path, value=None)\n    elif isinstance(value, (list, tuple)):\n        value = list_to_np_array(value)\n        self.columns[key] = Column(self.path, value)\n    elif isinstance(value, (np.ndarray)):\n        self.columns[key] = Column(self.path, value)\n    elif isinstance(value, Column):\n        self.columns[key] = value\n    else:\n        raise TypeError(f\"{type(value)} not supported.\")\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.__getitem__","title":"<code>tablite.core.Table.__getitem__(keys)</code>","text":"<p>Enables selection of columns and rows</p> PARAMETER  DESCRIPTION <code>keys</code> <p> TYPE: <code>column name, integer or slice</code> </p> <code>Examples</code> <p> </p> <code>&gt;&gt;&gt;</code> <p>10]                        selects first 10 rows from all columns</p> <p> TYPE: <code>table[</code> </p> <code>&gt;&gt;&gt;</code> <p>20:3] selects column 'b' and 'c' and 'a' twice for a slice.</p> <p> TYPE: <code>table['b', 'a', 'a', 'c', 2</code> </p> <p>Raises:     KeyError: if key is not found.     TypeError: if key is not a string, integer or slice.</p> RETURNS DESCRIPTION <code>Table</code> <p>returns columns in same order as selection.</p> Source code in <code>tablite/base.py</code> <pre><code>def __getitem__(self, keys):  # USER FUNCTION\n    \"\"\"\n    Enables selection of columns and rows\n\n    Args:\n        keys (column name, integer or slice):\n        Examples:\n        ```\n        &gt;&gt;&gt; table['a']                        selects column 'a'\n        &gt;&gt;&gt; table[3]                          selects row 3 as a tuple.\n        &gt;&gt;&gt; table[:10]                        selects first 10 rows from all columns\n        &gt;&gt;&gt; table['a','b', slice(3,20,2)]     selects a slice from columns 'a' and 'b'\n        &gt;&gt;&gt; table['b', 'a', 'a', 'c', 2:20:3] selects column 'b' and 'c' and 'a' twice for a slice.\n        &gt;&gt;&gt; table[('b', 'a', 'a', 'c')]       selects columns 'b', 'a', 'a', and 'c' using a tuple.\n        ```\n    Raises:\n        KeyError: if key is not found.\n        TypeError: if key is not a string, integer or slice.\n\n    Returns:\n        Table: returns columns in same order as selection.\n    \"\"\"\n\n    if not isinstance(keys, tuple):\n        if isinstance(keys, list):\n            keys = tuple(keys)\n        else:\n            keys = (keys,)\n    if isinstance(keys[0], tuple):\n        keys = tuple(list(chain(*keys)))\n\n    integers = [i for i in keys if isinstance(i, int)]\n    if len(integers) == len(keys) == 1:  # return a single tuple.\n        keys = [slice(keys[0])]\n\n    column_names = [i for i in keys if isinstance(i, str)]\n    column_names = list(self.columns) if not column_names else column_names\n    not_found = [name for name in column_names if name not in self.columns]\n    if not_found:\n        raise KeyError(f\"keys not found: {', '.join(not_found)}\")\n\n    slices = [i for i in keys if isinstance(i, slice)]\n    slc = slice(0, len(self)) if not slices else slices[0]\n\n    if (\n        len(slices) == 0 and len(column_names) == 1\n    ):  # e.g. tbl['a'] or tbl['a'][:10]\n        col = self.columns[column_names[0]]\n        if slices:\n            return col[slc]  # return slice from column as list of values\n        else:\n            return col  # return whole column\n\n    elif len(integers) == 1:  # return a single tuple.\n        row_no = integers[0]\n        slc = slice(row_no, row_no + 1)\n        return tuple(self.columns[name][slc].tolist()[0] for name in column_names)\n\n    elif not slices:  # e.g. new table with N whole columns.\n        return self.__class__(\n            columns={name: self.columns[name] for name in column_names}\n        )\n\n    else:  # e.g. new table from selection of columns and slices.\n        t = self.__class__()\n        for name in column_names:\n            column = self.columns[name]\n\n            new_column = Column(t.path)  # create new Column.\n            for item in column.getpages(slc):\n                if isinstance(item, np.ndarray):\n                    new_column.extend(item)  # extend subslice (expensive)\n                elif isinstance(item, SimplePage):\n                    new_column.pages.append(item)  # extend page (cheap)\n                else:\n                    raise TypeError(f\"Bad item: {item}\")\n\n            # below:\n            # set the new column directly on t.columns.\n            # Do not use t[name] as that triggers __setitem__ again.\n            t.columns[name] = new_column\n\n        return t\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.__len__","title":"<code>tablite.core.Table.__len__()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def __len__(self):  # USER FUNCTION.\n    if not self.columns:\n        return 0\n    return max(len(c) for c in self.columns.values())\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.__eq__","title":"<code>tablite.core.Table.__eq__(other) -&gt; bool</code>","text":"<p>Determines if two tables have identical content.</p> PARAMETER  DESCRIPTION <code>other</code> <p>table for comparison</p> <p> TYPE: <code>Table</code> </p> RETURNS DESCRIPTION <code>bool</code> <p>True if tables are identical.</p> <p> TYPE: <code>bool</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def __eq__(self, other) -&gt; bool:  # USER FUNCTION.\n    \"\"\"Determines if two tables have identical content.\n\n    Args:\n        other (Table): table for comparison\n\n    Returns:\n        bool: True if tables are identical.\n    \"\"\"\n    if isinstance(other, dict):\n        return self.items() == other.items()\n    if not isinstance(other, BaseTable):\n        return False\n    if id(self) == id(other):\n        return True\n    if len(self) != len(other):\n        return False\n    if len(self) == len(other) == 0:\n        return True\n    if self.columns.keys() != other.columns.keys():\n        return False\n    for name, col in self.columns.items():\n        if not (col == other.columns[name]):\n            return False\n    return True\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.clear","title":"<code>tablite.core.Table.clear()</code>","text":"<p>clears the table. Like dict().clear()</p> Source code in <code>tablite/base.py</code> <pre><code>def clear(self):  # USER FUNCTION.\n    \"\"\"clears the table. Like dict().clear()\"\"\"\n    self.columns.clear()\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.save","title":"<code>tablite.core.Table.save(path, compression_method=zipfile.ZIP_DEFLATED, compression_level=1)</code>","text":"<p>saves table to compressed tpz file.</p> PARAMETER  DESCRIPTION <code>path</code> <p>file destination.</p> <p> TYPE: <code>Path</code> </p> <code>compression_method</code> <p>See zipfile compression methods. Defaults to ZIP_DEFLATED.</p> <p> DEFAULT: <code>ZIP_DEFLATED</code> </p> <code>compression_level</code> <p>See zipfile compression levels. Defaults to 1.</p> <p> DEFAULT: <code>1</code> </p> <p>The file format is as follows: .tpz is a gzip archive with table metadata captured as table.yml and the necessary set of pages saved as .npy files.</p> <p>The zip contains table.yml which provides an overview of the data:</p> <pre><code>--------------------------------------\n%YAML 1.2                              yaml version\ncolumns:                               start of columns section.\n    name: \u201c\u5217 1\u201d                       name of column 1.\n        pages: [p1b1, p1b2]            list of pages in column 1.\n    name: \u201c\u5217 2\u201d                       name of column 2\n        pages: [p2b1, p2b2]            list of pages in column 2.\n----------------------------------------\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def save(\n    self, path, compression_method=zipfile.ZIP_DEFLATED, compression_level=1\n):  # USER FUNCTION.\n    \"\"\"saves table to compressed tpz file.\n\n    Args:\n        path (Path): file destination.\n        compression_method: See zipfile compression methods. Defaults to ZIP_DEFLATED.\n        compression_level: See zipfile compression levels. Defaults to 1.\n        The default settings produce 80% compression at 10% slowdown.\n\n    The file format is as follows:\n    .tpz is a gzip archive with table metadata captured as table.yml\n    and the necessary set of pages saved as .npy files.\n\n    The zip contains table.yml which provides an overview of the data:\n    ```\n    --------------------------------------\n    %YAML 1.2                              yaml version\n    columns:                               start of columns section.\n        name: \u201c\u5217 1\u201d                       name of column 1.\n            pages: [p1b1, p1b2]            list of pages in column 1.\n        name: \u201c\u5217 2\u201d                       name of column 2\n            pages: [p2b1, p2b2]            list of pages in column 2.\n    ----------------------------------------\n    ```\n    \"\"\"\n    if isinstance(path, str):\n        path = Path(path)\n    type_check(path, Path)\n    if path.is_dir():\n        raise TypeError(f\"filename needed: {path}\")\n    if path.suffix != \".tpz\":\n        path = path.parent / (path.parts[-1] + \".tpz\")\n\n    # create yaml document\n    _page_counter = 0\n    d = {}\n    cols = {}\n    for name, col in self.columns.items():\n        type_check(col, Column)\n        cols[name] = {\"pages\": [p.path.name for p in col.pages]}\n        _page_counter += len(col.pages)\n    d[\"columns\"] = cols\n    yml = yaml.safe_dump(\n        d, sort_keys=False, allow_unicode=True, default_flow_style=None\n    )\n\n    _file_counter = 0\n    with zipfile.ZipFile(\n        path, \"w\", compression=compression_method, compresslevel=compression_level\n    ) as f:\n        log.debug(f\"writing .tpz to {path} with\\n{yml}\")\n        f.writestr(\"table.yml\", yml)\n        for name, col in self.columns.items():\n            for page in set(\n                col.pages\n            ):  # set of pages! remember t *= 1000 repeats t 1000x\n                with open(page.path, \"rb\", buffering=0) as raw_io:\n                    f.writestr(page.path.name, raw_io.read())\n                _file_counter += 1\n                log.debug(f\"adding Page {page.path}\")\n\n        _fields = len(self) * len(self.columns)\n        _avg = _fields // _page_counter\n        log.debug(\n            f\"Wrote {_fields:,} on {_page_counter:,} pages in {_file_counter} files: {_avg} fields/page\"\n        )\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.load","title":"<code>tablite.core.Table.load(path, tqdm=_tqdm)</code>  <code>classmethod</code>","text":"<p>loads a table from .tpz file. See also Table.save for details on the file format.</p> PARAMETER  DESCRIPTION <code>path</code> <p>source file</p> <p> TYPE: <code>Path</code> </p> RETURNS DESCRIPTION <code>Table</code> <p>table in read-only mode.</p> Source code in <code>tablite/base.py</code> <pre><code>@classmethod\ndef load(cls, path, tqdm=_tqdm):  # USER FUNCTION.\n    \"\"\"loads a table from .tpz file.\n    See also Table.save for details on the file format.\n\n    Args:\n        path (Path): source file\n\n    Returns:\n        Table: table in read-only mode.\n    \"\"\"\n    path = Path(path)\n    log.debug(f\"loading {path}\")\n    with zipfile.ZipFile(path, \"r\") as f:\n        yml = f.read(\"table.yml\")\n        metadata = yaml.safe_load(yml)\n        t = cls()\n\n        page_count = sum([len(c[\"pages\"]) for c in metadata[\"columns\"].values()])\n\n        with tqdm(\n            total=page_count,\n            desc=f\"loading '{path.name}' file\",\n            disable=Config.TQDM_DISABLE,\n        ) as pbar:\n            for name, d in metadata[\"columns\"].items():\n                column = Column(t.path)\n                for page in d[\"pages\"]:\n                    bytestream = io.BytesIO(f.read(page))\n                    data = np.load(bytestream, allow_pickle=True, fix_imports=False)\n                    column.extend(data)\n                    pbar.update(1)\n                t.columns[name] = column\n    update_access_time(path)\n    return t\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.copy","title":"<code>tablite.core.Table.copy()</code>","text":"Source code in <code>tablite/base.py</code> <pre><code>def copy(self):\n    cls = type(self)\n    t = cls()\n    for name, column in self.columns.items():\n        new = Column(t.path)\n        new.pages = column.pages[:]\n        t.columns[name] = new\n    return t\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.__imul__","title":"<code>tablite.core.Table.__imul__(other)</code>","text":"<p>Repeats instance of table N times.</p> <p>Like list: <code>t = t * N</code></p> PARAMETER  DESCRIPTION <code>other</code> <p>multiplier</p> <p> TYPE: <code>int</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def __imul__(self, other):\n    \"\"\"Repeats instance of table N times.\n\n    Like list: `t = t * N`\n\n    Args:\n        other (int): multiplier\n    \"\"\"\n    if not (isinstance(other, int) and other &gt; 0):\n        raise TypeError(\n            f\"a table can be repeated an integer number of times, not {type(other)} number of times\"\n        )\n    for col in self.columns.values():\n        col *= other\n    return self\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.__mul__","title":"<code>tablite.core.Table.__mul__(other)</code>","text":"<p>Repeat table N times. Like list: <code>new = old * N</code></p> PARAMETER  DESCRIPTION <code>other</code> <p>multiplier</p> <p> TYPE: <code>int</code> </p> RETURNS DESCRIPTION <p>Table</p> Source code in <code>tablite/base.py</code> <pre><code>def __mul__(self, other):\n    \"\"\"Repeat table N times.\n    Like list: `new = old * N`\n\n    Args:\n        other (int): multiplier\n\n    Returns:\n        Table\n    \"\"\"\n    new = self.copy()\n    return new.__imul__(other)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.__iadd__","title":"<code>tablite.core.Table.__iadd__(other)</code>","text":"<p>Concatenates tables with same column names.</p> <p>Like list: <code>table_1 += table_2</code></p> RAISES DESCRIPTION <code>ValueError</code> <p>If column names don't match.</p> RETURNS DESCRIPTION <code>None</code> <p>self is updated.</p> Source code in <code>tablite/base.py</code> <pre><code>def __iadd__(self, other):\n    \"\"\"Concatenates tables with same column names.\n\n    Like list: `table_1 += table_2`\n\n    Args:\n        other (Table)\n\n    Raises:\n        ValueError: If column names don't match.\n\n    Returns:\n        None: self is updated.\n    \"\"\"\n    type_check(other, BaseTable)\n    for name in self.columns.keys():\n        if name not in other.columns:\n            raise ValueError(f\"{name} not in other\")\n    for name in other.columns.keys():\n        if name not in self.columns:\n            raise ValueError(f\"{name} missing from self\")\n\n    for name, column in self.columns.items():\n        other_col = other.columns.get(name, None)\n        column.pages.extend(other_col.pages[:])\n    return self\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.__add__","title":"<code>tablite.core.Table.__add__(other)</code>","text":"<p>Concatenates tables with same column names.</p> <p>Like list: <code>table_3 = table_1 + table_2</code></p> RAISES DESCRIPTION <code>ValueError</code> <p>If column names don't match.</p> RETURNS DESCRIPTION <p>Table</p> Source code in <code>tablite/base.py</code> <pre><code>def __add__(self, other):\n    \"\"\"Concatenates tables with same column names.\n\n    Like list: `table_3 = table_1 + table_2`\n\n    Args:\n        other (Table)\n\n    Raises:\n        ValueError: If column names don't match.\n\n    Returns:\n        Table\n    \"\"\"\n    type_check(other, BaseTable)\n    cp = self.copy()\n    cp += other\n    return cp\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.add_rows","title":"<code>tablite.core.Table.add_rows(*args, **kwargs)</code>","text":"<p>its more efficient to add many rows at once.</p> <p>if both args and kwargs, then args are added first, followed by kwargs.</p> <p>supported cases:</p> <pre><code>&gt;&gt;&gt; t = Table()\n&gt;&gt;&gt; t.add_columns('row','A','B','C')\n&gt;&gt;&gt; t.add_rows(1, 1, 2, 3)                              # (1) individual values as args\n&gt;&gt;&gt; t.add_rows([2, 1, 2, 3])                            # (2) list of values as args\n&gt;&gt;&gt; t.add_rows((3, 1, 2, 3))                            # (3) tuple of values as args\n&gt;&gt;&gt; t.add_rows(*(4, 1, 2, 3))                           # (4) unpacked tuple becomes arg like (1)\n&gt;&gt;&gt; t.add_rows(row=5, A=1, B=2, C=3)                    # (5) kwargs\n&gt;&gt;&gt; t.add_rows(**{'row': 6, 'A': 1, 'B': 2, 'C': 3})    # (6) dict / json interpreted a kwargs\n&gt;&gt;&gt; t.add_rows((7, 1, 2, 3), (8, 4, 5, 6))              # (7) two (or more) tuples as args\n&gt;&gt;&gt; t.add_rows([9, 1, 2, 3], [10, 4, 5, 6])             # (8) two or more lists as rgs\n&gt;&gt;&gt; t.add_rows(\n    {'row': 11, 'A': 1, 'B': 2, 'C': 3},\n    {'row': 12, 'A': 4, 'B': 5, 'C': 6}\n    )                                                   # (9) two (or more) dicts as args - roughly comma sep'd json.\n&gt;&gt;&gt; t.add_rows( *[\n    {'row': 13, 'A': 1, 'B': 2, 'C': 3},\n    {'row': 14, 'A': 1, 'B': 2, 'C': 3}\n    ])                                                  # (10) list of dicts as args\n&gt;&gt;&gt; t.add_rows(row=[15,16], A=[1,1], B=[2,2], C=[3,3])  # (11) kwargs with lists as values\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def add_rows(self, *args, **kwargs):\n    \"\"\"its more efficient to add many rows at once.\n\n    if both args and kwargs, then args are added first, followed by kwargs.\n\n    supported cases:\n    ```\n    &gt;&gt;&gt; t = Table()\n    &gt;&gt;&gt; t.add_columns('row','A','B','C')\n    &gt;&gt;&gt; t.add_rows(1, 1, 2, 3)                              # (1) individual values as args\n    &gt;&gt;&gt; t.add_rows([2, 1, 2, 3])                            # (2) list of values as args\n    &gt;&gt;&gt; t.add_rows((3, 1, 2, 3))                            # (3) tuple of values as args\n    &gt;&gt;&gt; t.add_rows(*(4, 1, 2, 3))                           # (4) unpacked tuple becomes arg like (1)\n    &gt;&gt;&gt; t.add_rows(row=5, A=1, B=2, C=3)                    # (5) kwargs\n    &gt;&gt;&gt; t.add_rows(**{'row': 6, 'A': 1, 'B': 2, 'C': 3})    # (6) dict / json interpreted a kwargs\n    &gt;&gt;&gt; t.add_rows((7, 1, 2, 3), (8, 4, 5, 6))              # (7) two (or more) tuples as args\n    &gt;&gt;&gt; t.add_rows([9, 1, 2, 3], [10, 4, 5, 6])             # (8) two or more lists as rgs\n    &gt;&gt;&gt; t.add_rows(\n        {'row': 11, 'A': 1, 'B': 2, 'C': 3},\n        {'row': 12, 'A': 4, 'B': 5, 'C': 6}\n        )                                                   # (9) two (or more) dicts as args - roughly comma sep'd json.\n    &gt;&gt;&gt; t.add_rows( *[\n        {'row': 13, 'A': 1, 'B': 2, 'C': 3},\n        {'row': 14, 'A': 1, 'B': 2, 'C': 3}\n        ])                                                  # (10) list of dicts as args\n    &gt;&gt;&gt; t.add_rows(row=[15,16], A=[1,1], B=[2,2], C=[3,3])  # (11) kwargs with lists as values\n    ```\n\n    \"\"\"\n    if not BaseTable._add_row_slow_warning:\n        warnings.warn(\n            \"add_rows is slow. Consider using add_columns and then assigning values to the columns directly.\"\n        )\n        BaseTable._add_row_slow_warning = True\n\n    if args:\n        if not all(isinstance(i, (list, tuple, dict)) for i in args):  # 1,4\n            args = [args]\n\n        if all(isinstance(i, (list, tuple, dict)) for i in args):  # 2,3,7,8\n            # 1. turn the data into columns:\n\n            d = {n: [] for n in self.columns}\n            for arg in args:\n                if len(arg) != len(self.columns):\n                    raise ValueError(\n                        f\"len({arg})== {len(arg)}, but there are {len(self.columns)} columns\"\n                    )\n\n                if isinstance(arg, dict):\n                    for k, v in arg.items():  # 7,8\n                        d[k].append(v)\n\n                elif isinstance(arg, (list, tuple)):  # 2,3\n                    for n, v in zip(self.columns, arg):\n                        d[n].append(v)\n\n                else:\n                    raise TypeError(f\"{arg}?\")\n            # 2. extend the columns\n            for n, values in d.items():\n                col = self.columns[n]\n                col.extend(list_to_np_array(values))\n\n    if kwargs:\n        if isinstance(kwargs, dict):\n            if all(isinstance(v, (list, tuple)) for v in kwargs.values()):\n                for k, v in kwargs.items():\n                    col = self.columns[k]\n                    col.extend(list_to_np_array(v))\n            else:\n                for k, v in kwargs.items():\n                    col = self.columns[k]\n                    col.extend(np.array([v]))\n        else:\n            raise ValueError(f\"format not recognised: {kwargs}\")\n\n    return\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.add_columns","title":"<code>tablite.core.Table.add_columns(*names)</code>","text":"<p>Adds column names to table.</p> Source code in <code>tablite/base.py</code> <pre><code>def add_columns(self, *names):\n    \"\"\"Adds column names to table.\"\"\"\n    for name in names:\n        self.columns[name] = Column(self.path)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.add_column","title":"<code>tablite.core.Table.add_column(name, data=None)</code>","text":"<p>verbose alias for table[name] = data, that checks if name already exists</p> PARAMETER  DESCRIPTION <code>name</code> <p>column name</p> <p> TYPE: <code>str</code> </p> <code>data</code> <p>values. Defaults to None.</p> <p> TYPE: <code>list,tuple)</code> DEFAULT: <code>None</code> </p> RAISES DESCRIPTION <code>TypeError</code> <p>name isn't string</p> <code>ValueError</code> <p>name already exists</p> Source code in <code>tablite/base.py</code> <pre><code>def add_column(self, name, data=None):\n    \"\"\"verbose alias for table[name] = data, that checks if name already exists\n\n    Args:\n        name (str): column name\n        data ((list,tuple), optional): values. Defaults to None.\n\n    Raises:\n        TypeError: name isn't string\n        ValueError: name already exists\n    \"\"\"\n    if not isinstance(name, str):\n        raise TypeError(\"expected name as string\")\n    if name in self.columns:\n        raise ValueError(f\"{name} already in {self.columns}\")\n    self.__setitem__(name, data)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.stack","title":"<code>tablite.core.Table.stack(other)</code>","text":"<p>returns the joint stack of tables with overlapping column names. Example:</p> <pre><code>| Table A|  +  | Table B| = |  Table AB |\n| A| B| C|     | A| B| D|   | A| B| C| -|\n                            | A| B| -| D|\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def stack(self, other):\n    \"\"\"\n    returns the joint stack of tables with overlapping column names.\n    Example:\n    ```\n    | Table A|  +  | Table B| = |  Table AB |\n    | A| B| C|     | A| B| D|   | A| B| C| -|\n                                | A| B| -| D|\n    ```\n    \"\"\"\n    if not isinstance(other, BaseTable):\n        raise TypeError(f\"stack only works for Table, not {type(other)}\")\n\n    cp = self.copy()\n    for name, col2 in other.columns.items():\n        if name not in cp.columns:\n            cp[name] = [None] * len(self)\n        cp[name].pages.extend(col2.pages[:])\n\n    for name in self.columns:\n        if name not in other.columns:\n            if len(cp) &gt; 0:\n                cp[name].extend(np.array([None] * len(other)))\n    return cp\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.types","title":"<code>tablite.core.Table.types()</code>","text":"<p>returns nested dict of data types in the form: <code>{column name: {python type class: number of instances }, ... }</code></p> <p>example:</p> <pre><code>&gt;&gt;&gt; t.types()\n{\n    'A': {&lt;class 'str'&gt;: 7},\n    'B': {&lt;class 'int'&gt;: 7}\n}\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def types(self):\n    \"\"\"\n    returns nested dict of data types in the form:\n    `{column name: {python type class: number of instances }, ... }`\n\n    example:\n    ```\n    &gt;&gt;&gt; t.types()\n    {\n        'A': {&lt;class 'str'&gt;: 7},\n        'B': {&lt;class 'int'&gt;: 7}\n    }\n    ```\n    \"\"\"\n    d = {}\n    for name, col in self.columns.items():\n        assert isinstance(col, Column)\n        d[name] = col.types()\n    return d\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.display_dict","title":"<code>tablite.core.Table.display_dict(slice_=None, blanks=None, dtype=False)</code>","text":"<p>helper for creating dict for display.</p> PARAMETER  DESCRIPTION <code>slice_</code> <p>python slice. Defaults to None.</p> <p> TYPE: <code>slice</code> DEFAULT: <code>None</code> </p> <code>blanks</code> <p>fill value for <code>None</code>. Defaults to None.</p> <p> TYPE: <code>optional</code> DEFAULT: <code>None</code> </p> <code>dtype</code> <p>Adds datatype to each column. Defaults to False.</p> <p> TYPE: <code>bool</code> DEFAULT: <code>False</code> </p> RAISES DESCRIPTION <code>TypeError</code> <p>slice_ must be None or slice.</p> RETURNS DESCRIPTION <code>dict</code> <p>from Table.</p> Source code in <code>tablite/base.py</code> <pre><code>def display_dict(self, slice_=None, blanks=None, dtype=False):\n    \"\"\"helper for creating dict for display.\n\n    Args:\n        slice_ (slice, optional): python slice. Defaults to None.\n        blanks (optional): fill value for `None`. Defaults to None.\n        dtype (bool, optional): Adds datatype to each column. Defaults to False.\n\n    Raises:\n        TypeError: slice_ must be None or slice.\n\n    Returns:\n        dict: from Table.\n    \"\"\"\n    if not self.columns:\n        print(\"Empty Table\")\n        return\n\n    def datatype(col):  # PRIVATE\n        \"\"\"creates label for column datatype.\"\"\"\n        types = col.types()\n        if len(types) == 0:\n            typ = \"empty\"\n        elif len(types) == 1:\n            dt, _ = types.popitem()\n            typ = dt.__name__\n        else:\n            typ = \"mixed\"\n        return typ\n\n    row_count_tags = [\"#\", \"~\", \"*\"]\n    cols = set(self.columns)\n    for n, tag in product(range(1, 6), row_count_tags):\n        if n * tag not in cols:\n            tag = n * tag\n            break\n\n    if not isinstance(slice_, (slice, type(None))):\n        raise TypeError(f\"slice_ must be None or slice, not {type(slice_)}\")\n    if isinstance(slice_, slice):\n        slc = slice_\n    if slice_ is None:\n        if len(self) &lt;= 20:\n            slc = slice(0, 20, 1)\n        else:\n            slc = None\n\n    n = len(self)\n    if slc:  # either we want slc or we want everything.\n        row_no = list(range(*slc.indices(len(self))))\n        data = {tag: [f\"{i:,}\".rjust(2) for i in row_no]}\n        for name, col in self.columns.items():\n            data[name] = list(chain(iter(col), repeat(blanks, times=n - len(col))))[\n                slc\n            ]\n    else:\n        data = {}\n        j = int(math.ceil(math.log10(n)) / 3) + len(str(n))\n        row_no = (\n            [f\"{i:,}\".rjust(j) for i in range(7)]\n            + [\"...\"]\n            + [f\"{i:,}\".rjust(j) for i in range(n - 7, n)]\n        )\n        data = {tag: row_no}\n\n        for name, col in self.columns.items():\n            if len(col) == n:\n                row = col[:7].tolist() + [\"...\"] + col[-7:].tolist()\n            else:\n                empty = [blanks] * 7\n                head = (col[:7].tolist() + empty)[:7]\n                tail = (col[n - 7 :].tolist() + empty)[-7:]\n                row = head + [\"...\"] + tail\n            data[name] = row\n\n    if dtype:\n        for name, values in data.items():\n            if name in self.columns:\n                col = self.columns[name]\n                values.insert(0, datatype(col))\n            else:\n                values.insert(0, \"row\")\n\n    return data\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_ascii","title":"<code>tablite.core.Table.to_ascii(slice_=None, blanks=None, dtype=False)</code>","text":"<p>returns ascii view of table as string.</p> PARAMETER  DESCRIPTION <code>slice_</code> <p>slice to determine table snippet.</p> <p> TYPE: <code>slice</code> DEFAULT: <code>None</code> </p> <code>blanks</code> <p>value for whitespace. Defaults to None.</p> <p> TYPE: <code>str</code> DEFAULT: <code>None</code> </p> <code>dtype</code> <p>adds subheader with datatype for column. Defaults to False.</p> <p> TYPE: <code>bool</code> DEFAULT: <code>False</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def to_ascii(self, slice_=None, blanks=None, dtype=False):\n    \"\"\"returns ascii view of table as string.\n\n    Args:\n        slice_ (slice, optional): slice to determine table snippet.\n        blanks (str, optional): value for whitespace. Defaults to None.\n        dtype (bool, optional): adds subheader with datatype for column. Defaults to False.\n    \"\"\"\n\n    def adjust(v, length):  # PRIVATE FUNCTION\n        \"\"\"whitespace justifies field values based on datatype\"\"\"\n        if v is None:\n            return str(blanks).ljust(length)\n        elif isinstance(v, str):\n            return v.ljust(length)\n        else:\n            return str(v).rjust(length)\n\n    if not self.columns:\n        return str(self)\n\n    d = {}\n    for name, values in self.display_dict(\n        slice_=slice_, blanks=blanks, dtype=dtype\n    ).items():\n        as_text = [str(v) for v in values] + [str(name)]\n        width = max(len(i) for i in as_text)\n        new_name = name.center(width, \" \")\n        if dtype:\n            values[0] = values[0].center(width, \" \")\n        d[new_name] = [adjust(v, width) for v in values]\n\n    rows = dict_to_rows(d)\n    s = []\n    s.append(\"+\" + \"+\".join([\"=\" * len(n) for n in rows[0]]) + \"+\")\n    s.append(\"|\" + \"|\".join(rows[0]) + \"|\")  # column names\n    start = 1\n    if dtype:\n        s.append(\"|\" + \"|\".join(rows[1]) + \"|\")  # datatypes\n        start = 2\n\n    s.append(\"+\" + \"+\".join([\"-\" * len(n) for n in rows[0]]) + \"+\")\n    for row in rows[start:]:\n        s.append(\"|\" + \"|\".join(row) + \"|\")\n    s.append(\"+\" + \"+\".join([\"=\" * len(n) for n in rows[0]]) + \"+\")\n\n    if len(set(len(c) for c in self.columns.values())) != 1:\n        warning = f\"Warning: Columns have different lengths. {blanks} is used as fill value.\"\n        s.append(warning)\n\n    return \"\\n\".join(s)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.show","title":"<code>tablite.core.Table.show(slice_=None, blanks=None, dtype=False)</code>","text":"<p>prints ascii view of table.</p> PARAMETER  DESCRIPTION <code>slice_</code> <p>slice to determine table snippet.</p> <p> TYPE: <code>slice</code> DEFAULT: <code>None</code> </p> <code>blanks</code> <p>value for whitespace. Defaults to None.</p> <p> TYPE: <code>str</code> DEFAULT: <code>None</code> </p> <code>dtype</code> <p>adds subheader with datatype for column. Defaults to False.</p> <p> TYPE: <code>bool</code> DEFAULT: <code>False</code> </p> Source code in <code>tablite/base.py</code> <pre><code>def show(self, slice_=None, blanks=None, dtype=False):\n    \"\"\"prints ascii view of table.\n\n    Args:\n        slice_ (slice, optional): slice to determine table snippet.\n        blanks (str, optional): value for whitespace. Defaults to None.\n        dtype (bool, optional): adds subheader with datatype for column. Defaults to False.\n    \"\"\"\n    print(self.to_ascii(slice_=slice_, blanks=blanks, dtype=dtype))\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_dict","title":"<code>tablite.core.Table.to_dict(columns=None, slice_=None)</code>","text":"<p>columns: list of column names. Default is None == all columns. slice_: slice. Default is None == all rows.</p> <p>returns: dict with columns as keys and lists of values.</p> <p>Example:</p> <pre><code>&gt;&gt;&gt; t.show()\n+===+===+===+\n| # | a | b |\n|row|int|int|\n+---+---+---+\n| 0 |  1|  3|\n| 1 |  2|  4|\n+===+===+===+\n&gt;&gt;&gt; t.to_dict()\n{'a':[1,2], 'b':[3,4]}\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def to_dict(self, columns=None, slice_=None):\n    \"\"\"\n    columns: list of column names. Default is None == all columns.\n    slice_: slice. Default is None == all rows.\n\n    returns: dict with columns as keys and lists of values.\n\n    Example:\n    ```\n    &gt;&gt;&gt; t.show()\n    +===+===+===+\n    | # | a | b |\n    |row|int|int|\n    +---+---+---+\n    | 0 |  1|  3|\n    | 1 |  2|  4|\n    +===+===+===+\n    &gt;&gt;&gt; t.to_dict()\n    {'a':[1,2], 'b':[3,4]}\n    ```\n\n    \"\"\"\n    if slice_ is None:\n        slice_ = slice(0, len(self))\n    assert isinstance(slice_, slice)\n\n    if columns is None:\n        columns = list(self.columns.keys())\n    if not isinstance(columns, list):\n        raise TypeError(\"expected columns as list of strings\")\n\n    return {name: list(self.columns[name][slice_]) for name in columns}\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.as_json_serializable","title":"<code>tablite.core.Table.as_json_serializable(row_count='row id', start_on=1, columns=None, slice_=None)</code>","text":"<p>provides a JSON compatible format of the table.</p> PARAMETER  DESCRIPTION <code>row_count</code> <p>Label for row counts. Defaults to \"row id\".</p> <p> TYPE: <code>str</code> DEFAULT: <code>'row id'</code> </p> <code>start_on</code> <p>row counts starts by default on 1.</p> <p> TYPE: <code>int</code> DEFAULT: <code>1</code> </p> <code>columns</code> <p>Column names. Defaults to None which returns all columns.</p> <p> TYPE: <code>list of str</code> DEFAULT: <code>None</code> </p> <code>slice_</code> <p>selector. Defaults to None which returns [:]</p> <p> TYPE: <code>slice</code> DEFAULT: <code>None</code> </p> RETURNS DESCRIPTION <p>JSON serializable dict: All python datatypes have been converted to JSON compliant data.</p> Source code in <code>tablite/base.py</code> <pre><code>def as_json_serializable(\n    self, row_count=\"row id\", start_on=1, columns=None, slice_=None\n):\n    \"\"\"provides a JSON compatible format of the table.\n\n    Args:\n        row_count (str, optional): Label for row counts. Defaults to \"row id\".\n        start_on (int, optional): row counts starts by default on 1.\n        columns (list of str, optional): Column names.\n            Defaults to None which returns all columns.\n        slice_ (slice, optional): selector. Defaults to None which returns [:]\n\n    Returns:\n        JSON serializable dict: All python datatypes have been converted to JSON compliant data.\n    \"\"\"\n    if slice_ is None:\n        slice_ = slice(0, len(self))\n\n    assert isinstance(slice_, slice)\n    new = {\"columns\": {}, \"total_rows\": len(self)}\n    if row_count is not None:\n        new[\"columns\"][row_count] = [\n            i + start_on for i in range(*slice_.indices(len(self)))\n        ]\n\n    d = self.to_dict(columns, slice_=slice_)\n    for k, data in d.items():\n        new_k = unique_name(\n            k, new[\"columns\"]\n        )  # used to avoid overwriting the `row id` key.\n        new[\"columns\"][new_k] = [\n            DataTypes.to_json(v) for v in data\n        ]  # deal with non-json datatypes.\n    return new\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.index","title":"<code>tablite.core.Table.index(*args)</code>","text":"<p>param: *args: column names returns multikey index on the columns as d[(key tuple, )] = {index1, index2, ...}</p> <p>Examples:</p> <pre><code>&gt;&gt;&gt; table6 = Table()\n&gt;&gt;&gt; table6['A'] = ['Alice', 'Bob', 'Bob', 'Ben', 'Charlie', 'Ben','Albert']\n&gt;&gt;&gt; table6['B'] = ['Alison', 'Marley', 'Dylan', 'Affleck', 'Hepburn', 'Barnes', 'Einstein']\n</code></pre> <pre><code>&gt;&gt;&gt; table6.index('A')  # single key.\n{('Alice',): [0],\n ('Bob',): [1, 2],\n ('Ben',): [3, 5],\n ('Charlie',): [4],\n ('Albert',): [6]})\n</code></pre> <pre><code>&gt;&gt;&gt; table6.index('A', 'B')  # multiple keys.\n{('Alice', 'Alison'): [0],\n ('Bob', 'Marley'): [1],\n ('Bob', 'Dylan'): [2],\n ('Ben', 'Affleck'): [3],\n ('Charlie', 'Hepburn'): [4],\n ('Ben', 'Barnes'): [5],\n ('Albert', 'Einstein'): [6]})\n</code></pre> Source code in <code>tablite/base.py</code> <pre><code>def index(self, *args):\n    \"\"\"\n    param: *args: column names\n    returns multikey index on the columns as d[(key tuple, )] = {index1, index2, ...}\n\n    Examples:\n        ```\n        &gt;&gt;&gt; table6 = Table()\n        &gt;&gt;&gt; table6['A'] = ['Alice', 'Bob', 'Bob', 'Ben', 'Charlie', 'Ben','Albert']\n        &gt;&gt;&gt; table6['B'] = ['Alison', 'Marley', 'Dylan', 'Affleck', 'Hepburn', 'Barnes', 'Einstein']\n        ```\n\n        ```\n        &gt;&gt;&gt; table6.index('A')  # single key.\n        {('Alice',): [0],\n         ('Bob',): [1, 2],\n         ('Ben',): [3, 5],\n         ('Charlie',): [4],\n         ('Albert',): [6]})\n        ```\n\n        ```\n        &gt;&gt;&gt; table6.index('A', 'B')  # multiple keys.\n        {('Alice', 'Alison'): [0],\n         ('Bob', 'Marley'): [1],\n         ('Bob', 'Dylan'): [2],\n         ('Ben', 'Affleck'): [3],\n         ('Charlie', 'Hepburn'): [4],\n         ('Ben', 'Barnes'): [5],\n         ('Albert', 'Einstein'): [6]})\n        ```\n\n    \"\"\"\n    idx = defaultdict(list)\n    iterators = [iter(self.columns[c]) for c in args]\n    for ix, key in enumerate(zip(*iterators)):\n        key = tuple(numpy_to_python(k) for k in key)\n        idx[key].append(ix)\n    return idx\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.unique_index","title":"<code>tablite.core.Table.unique_index(*args, tqdm=_tqdm)</code>","text":"<p>generates the index of unique rows given a list of column names</p> PARAMETER  DESCRIPTION <code>*args</code> <p>columns names</p> <p> TYPE: <code>any</code> DEFAULT: <code>()</code> </p> <code>tqdm</code> <p>Defaults to _tqdm.</p> <p> TYPE: <code>tqdm</code> DEFAULT: <code>tqdm</code> </p> RETURNS DESCRIPTION <p>np.array(int64): indices of unique records.</p> Source code in <code>tablite/base.py</code> <pre><code>def unique_index(self, *args, tqdm=_tqdm):\n    \"\"\"generates the index of unique rows given a list of column names\n\n    Args:\n        *args (any): columns names\n        tqdm (tqdm, optional): Defaults to _tqdm.\n\n    Returns:\n        np.array(int64): indices of unique records.\n    \"\"\"\n    if not args:\n        raise ValueError(\"*args (column names) is required\")\n    seen = set()\n    unique = set()\n    iterators = [iter(self.columns[c]) for c in args]\n    for ix, key in tqdm(enumerate(zip(*iterators)), disable=Config.TQDM_DISABLE):\n        key_hash = hash(tuple(numpy_to_python(k) for k in key))\n        if key_hash in seen:\n            continue\n        else:\n            seen.add(key_hash)\n            unique.add(ix)\n    return np.array(sorted(unique))\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.from_file","title":"<code>tablite.core.Table.from_file(path, columns=None, first_row_has_headers=True, header_row_index=0, encoding=None, start=0, limit=sys.maxsize, sheet=None, guess_datatypes=True, newline='\\n', text_qualifier=None, delimiter=None, strip_leading_and_tailing_whitespace=True, text_escape_openings='', text_escape_closures='', skip_empty: ValidSkipEmpty = 'NONE', tqdm=_tqdm) -&gt; Table</code>  <code>classmethod</code>","text":"<pre><code>    reads path and imports 1 or more tables\n\n    REQUIRED\n    --------\n    path: pathlib.Path or str\n        selection of filereader uses path.suffix.\n        See `filereaders`.\n\n    OPTIONAL\n    --------\n    columns:\n        None: (default) All columns will be imported.\n        List: only column names from list will be imported (if present in file)\n              e.g. ['A', 'B', 'C', 'D']\n\n              datatype is detected using Datatypes.guess(...)\n              You can try it out with:\n              &gt;&gt; from tablite.datatypes import DataTypes\n              &gt;&gt; DataTypes.guess(['001','100'])\n              [1,100]\n\n              if the format cannot be achieved the read type is kept.\n        Excess column names are ignored.\n\n        HINT: To get the head of file use:\n        &gt;&gt;&gt; from tablite.tools import head\n        &gt;&gt;&gt; head = head(path)\n\n    first_row_has_headers: boolean\n        True: (default) first row is used as column names.\n        False: integers are used as column names.\n\n    encoding: str. Defaults to None (autodetect using n bytes).\n        n is declared in filereader_utils as ENCODING_GUESS_BYTES\n\n    start: the first line to be read (default: 0)\n\n    limit: the number of lines to be read from start (default sys.maxint ~ 2**63)\n\n    OPTIONAL FOR EXCEL AND ODS READERS\n    ----------------------------------\n\n    sheet: sheet name to import  (applicable to excel- and ods-reader only)\n        e.g. 'sheet_1'\n        sheets not found excess names are ignored.\n\n    OPTIONAL FOR TEXT READERS\n    -------------------------\n    guess_datatype: bool\n        True: (default) datatypes are guessed using DataTypes.guess(...)\n        False: all data is imported as strings.\n\n    newline: newline character (applicable to text_reader only)\n        str: '\n</code></pre> <p>' (default) or ' '</p> <pre><code>    text_qualifier: character (applicable to text_reader only)\n        None: No text qualifier is used.\n        str: \" or '\n\n    delimiter: character (applicable to text_reader only)\n        None: file suffix is used to determine field delimiter:\n            .txt: \"|\"\n            .csv: \",\",\n            .ssv: \";\"\n            .tsv: \" \" (tab)\n\n    strip_leading_and_tailing_whitespace: bool:\n        True: default\n\n    text_escape_openings: (applicable to text_reader only)\n        None: default\n        str: list of characters such as ([{\n\n    text_escape_closures: (applicable to text_reader only)\n        None: default\n        str: list of characters such as }])\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>@classmethod\ndef from_file(\n    cls,\n    path,\n    columns=None,\n    first_row_has_headers=True,\n    header_row_index=0,\n    encoding=None,\n    start=0,\n    limit=sys.maxsize,\n    sheet=None,\n    guess_datatypes=True,\n    newline=\"\\n\",\n    text_qualifier=None,\n    delimiter=None,\n    strip_leading_and_tailing_whitespace=True,\n    text_escape_openings=\"\",\n    text_escape_closures=\"\",\n    skip_empty: ValidSkipEmpty=\"NONE\",\n    tqdm=_tqdm,\n) -&gt; \"Table\":\n    \"\"\"\n    reads path and imports 1 or more tables\n\n    REQUIRED\n    --------\n    path: pathlib.Path or str\n        selection of filereader uses path.suffix.\n        See `filereaders`.\n\n    OPTIONAL\n    --------\n    columns:\n        None: (default) All columns will be imported.\n        List: only column names from list will be imported (if present in file)\n              e.g. ['A', 'B', 'C', 'D']\n\n              datatype is detected using Datatypes.guess(...)\n              You can try it out with:\n              &gt;&gt; from tablite.datatypes import DataTypes\n              &gt;&gt; DataTypes.guess(['001','100'])\n              [1,100]\n\n              if the format cannot be achieved the read type is kept.\n        Excess column names are ignored.\n\n        HINT: To get the head of file use:\n        &gt;&gt;&gt; from tablite.tools import head\n        &gt;&gt;&gt; head = head(path)\n\n    first_row_has_headers: boolean\n        True: (default) first row is used as column names.\n        False: integers are used as column names.\n\n    encoding: str. Defaults to None (autodetect using n bytes).\n        n is declared in filereader_utils as ENCODING_GUESS_BYTES\n\n    start: the first line to be read (default: 0)\n\n    limit: the number of lines to be read from start (default sys.maxint ~ 2**63)\n\n    OPTIONAL FOR EXCEL AND ODS READERS\n    ----------------------------------\n\n    sheet: sheet name to import  (applicable to excel- and ods-reader only)\n        e.g. 'sheet_1'\n        sheets not found excess names are ignored.\n\n    OPTIONAL FOR TEXT READERS\n    -------------------------\n    guess_datatype: bool\n        True: (default) datatypes are guessed using DataTypes.guess(...)\n        False: all data is imported as strings.\n\n    newline: newline character (applicable to text_reader only)\n        str: '\\n' (default) or '\\r\\n'\n\n    text_qualifier: character (applicable to text_reader only)\n        None: No text qualifier is used.\n        str: \" or '\n\n    delimiter: character (applicable to text_reader only)\n        None: file suffix is used to determine field delimiter:\n            .txt: \"|\"\n            .csv: \",\",\n            .ssv: \";\"\n            .tsv: \"\\t\" (tab)\n\n    strip_leading_and_tailing_whitespace: bool:\n        True: default\n\n    text_escape_openings: (applicable to text_reader only)\n        None: default\n        str: list of characters such as ([{\n\n    text_escape_closures: (applicable to text_reader only)\n        None: default\n        str: list of characters such as }])\n\n    \"\"\"\n    if isinstance(path, str):\n        path = Path(path)\n    type_check(path, Path)\n\n    if not path.exists():\n        raise FileNotFoundError(f\"file not found: {path}\")\n\n    if not isinstance(start, int) or not 0 &lt;= start &lt;= sys.maxsize:\n        raise ValueError(f\"start {start} not in range(0,{sys.maxsize})\")\n\n    if not isinstance(limit, int) or not 0 &lt; limit &lt;= sys.maxsize:\n        raise ValueError(f\"limit {limit} not in range(0,{sys.maxsize})\")\n\n    if not isinstance(first_row_has_headers, bool):\n        raise TypeError(\"first_row_has_headers is not bool\")\n\n    import_as = path.suffix\n    if import_as.startswith(\".\"):\n        import_as = import_as[1:]\n\n    reader = import_utils.file_readers.get(import_as, None)\n    if reader is None:\n        raise ValueError(f\"{import_as} is not in supported format: {import_utils.valid_readers}\")\n\n    additional_configs = {\"tqdm\": tqdm}\n    if reader == import_utils.text_reader:\n        # here we inject tqdm, if tqdm is not provided, use generic iterator\n        # fmt:off\n        config = (path, columns, first_row_has_headers, header_row_index, encoding, start, limit, newline,\n                  guess_datatypes, text_qualifier, strip_leading_and_tailing_whitespace, skip_empty,\n                  delimiter, text_escape_openings, text_escape_closures)\n        # fmt:on\n\n    elif reader == import_utils.from_html:\n        config = (path,)\n    elif reader == import_utils.from_hdf5:\n        config = (path,)\n\n    elif reader == import_utils.excel_reader:\n        # config = path, first_row_has_headers, sheet, columns, start, limit\n        config = (\n            path,\n            first_row_has_headers,\n            header_row_index,\n            sheet,\n            columns,\n            skip_empty,\n            start,\n            limit,\n        )  # if file length changes - re-import.\n\n    if reader == import_utils.ods_reader:\n        # path, first_row_has_headers=True, sheet=None, columns=None, start=0, limit=sys.maxsize,\n        config = (\n            str(path),\n            first_row_has_headers,\n            header_row_index,\n            sheet,\n            columns,\n            skip_empty,\n            start,\n            limit,\n        )  # if file length changes - re-import.\n\n    # At this point the import config seems valid.\n    # Now we check if the file already has been imported.\n\n    # publish the settings\n    return reader(cls, *config, **additional_configs)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.from_pandas","title":"<code>tablite.core.Table.from_pandas(df)</code>  <code>classmethod</code>","text":"<p>Creates Table using pd.to_dict('list')</p> <p>similar to:</p> <pre><code>&gt;&gt;&gt; import pandas as pd\n&gt;&gt;&gt; df = pd.DataFrame({'a':[1,2,3], 'b':[4,5,6]})\n&gt;&gt;&gt; df\n    a  b\n    0  1  4\n    1  2  5\n    2  3  6\n&gt;&gt;&gt; df.to_dict('list')\n{'a': [1, 2, 3], 'b': [4, 5, 6]}\n&gt;&gt;&gt; t = Table.from_dict(df.to_dict('list))\n&gt;&gt;&gt; t.show()\n    +===+===+===+\n    | # | a | b |\n    |row|int|int|\n    +---+---+---+\n    | 0 |  1|  4|\n    | 1 |  2|  5|\n    | 2 |  3|  6|\n    +===+===+===+\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>@classmethod\ndef from_pandas(cls, df):\n    \"\"\"\n    Creates Table using pd.to_dict('list')\n\n    similar to:\n    ```\n    &gt;&gt;&gt; import pandas as pd\n    &gt;&gt;&gt; df = pd.DataFrame({'a':[1,2,3], 'b':[4,5,6]})\n    &gt;&gt;&gt; df\n        a  b\n        0  1  4\n        1  2  5\n        2  3  6\n    &gt;&gt;&gt; df.to_dict('list')\n    {'a': [1, 2, 3], 'b': [4, 5, 6]}\n    &gt;&gt;&gt; t = Table.from_dict(df.to_dict('list))\n    &gt;&gt;&gt; t.show()\n        +===+===+===+\n        | # | a | b |\n        |row|int|int|\n        +---+---+---+\n        | 0 |  1|  4|\n        | 1 |  2|  5|\n        | 2 |  3|  6|\n        +===+===+===+\n    ```\n    \"\"\"\n    return import_utils.from_pandas(cls, df)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.from_hdf5","title":"<code>tablite.core.Table.from_hdf5(path)</code>  <code>classmethod</code>","text":"<p>imports an exported hdf5 table.</p> Source code in <code>tablite/core.py</code> <pre><code>@classmethod\ndef from_hdf5(cls, path):\n    \"\"\"\n    imports an exported hdf5 table.\n    \"\"\"\n    return import_utils.from_hdf5(cls, path)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.from_json","title":"<code>tablite.core.Table.from_json(jsn)</code>  <code>classmethod</code>","text":"<p>Imports table exported using .to_json</p> Source code in <code>tablite/core.py</code> <pre><code>@classmethod\ndef from_json(cls, jsn):\n    \"\"\"\n    Imports table exported using .to_json\n    \"\"\"\n    return import_utils.from_json(cls, jsn)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_hdf5","title":"<code>tablite.core.Table.to_hdf5(path)</code>","text":"<p>creates a copy of the table as hdf5</p> Source code in <code>tablite/core.py</code> <pre><code>def to_hdf5(self, path):\n    \"\"\"\n    creates a copy of the table as hdf5\n    \"\"\"\n    export_utils.to_hdf5(self, path)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_pandas","title":"<code>tablite.core.Table.to_pandas()</code>","text":"<p>returns pandas.DataFrame</p> Source code in <code>tablite/core.py</code> <pre><code>def to_pandas(self):\n    \"\"\"\n    returns pandas.DataFrame\n    \"\"\"\n    return export_utils.to_pandas(self)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_sql","title":"<code>tablite.core.Table.to_sql(name)</code>","text":"<p>generates ANSI-92 compliant SQL.</p> Source code in <code>tablite/core.py</code> <pre><code>def to_sql(self, name):\n    \"\"\"\n    generates ANSI-92 compliant SQL.\n    \"\"\"\n    return export_utils.to_sql(self, name)  # remove after update to test suite.\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_json","title":"<code>tablite.core.Table.to_json()</code>","text":"<p>returns JSON</p> Source code in <code>tablite/core.py</code> <pre><code>def to_json(self):\n    \"\"\"\n    returns JSON\n    \"\"\"\n    return export_utils.to_json(self)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_xlsx","title":"<code>tablite.core.Table.to_xlsx(path)</code>","text":"<p>exports table to path</p> Source code in <code>tablite/core.py</code> <pre><code>def to_xlsx(self, path):\n    \"\"\"\n    exports table to path\n    \"\"\"\n    export_utils.path_suffix_check(path, \".xlsx\")\n    export_utils.excel_writer(self, path)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_ods","title":"<code>tablite.core.Table.to_ods(path)</code>","text":"<p>exports table to path</p> Source code in <code>tablite/core.py</code> <pre><code>def to_ods(self, path):\n    \"\"\"\n    exports table to path\n    \"\"\"\n    export_utils.path_suffix_check(path, \".ods\")\n    export_utils.excel_writer(self, path)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_csv","title":"<code>tablite.core.Table.to_csv(path)</code>","text":"<p>exports table to path</p> Source code in <code>tablite/core.py</code> <pre><code>def to_csv(self, path):\n    \"\"\"\n    exports table to path\n    \"\"\"\n    export_utils.path_suffix_check(path, \".csv\")\n    export_utils.text_writer(self, path)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_tsv","title":"<code>tablite.core.Table.to_tsv(path)</code>","text":"<p>exports table to path</p> Source code in <code>tablite/core.py</code> <pre><code>def to_tsv(self, path):\n    \"\"\"\n    exports table to path\n    \"\"\"\n    export_utils.path_suffix_check(path, \".tsv\")\n    export_utils.text_writer(self, path)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_text","title":"<code>tablite.core.Table.to_text(path)</code>","text":"<p>exports table to path</p> Source code in <code>tablite/core.py</code> <pre><code>def to_text(self, path):\n    \"\"\"\n    exports table to path\n    \"\"\"\n    export_utils.path_suffix_check(path, \".txt\")\n    export_utils.text_writer(self, path)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.to_html","title":"<code>tablite.core.Table.to_html(path)</code>","text":"<p>exports table to path</p> Source code in <code>tablite/core.py</code> <pre><code>def to_html(self, path):\n    \"\"\"\n    exports table to path\n    \"\"\"\n    export_utils.path_suffix_check(path, \".html\")\n    export_utils.to_html(self, path)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.expression","title":"<code>tablite.core.Table.expression(expression)</code>","text":"<p>filters based on an expression, such as:</p> <pre><code>\"all((A==B, C!=4, 200&lt;D))\"\n</code></pre> <p>which is interpreted using python's compiler to:</p> <pre><code>def _f(A,B,C,D):\n    return all((A==B, C!=4, 200&lt;D))\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>def expression(self, expression):\n    \"\"\"\n    filters based on an expression, such as:\n\n        \"all((A==B, C!=4, 200&lt;D))\"\n\n    which is interpreted using python's compiler to:\n\n        def _f(A,B,C,D):\n            return all((A==B, C!=4, 200&lt;D))\n    \"\"\"\n    return redux._filter_using_expression(self, expression)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.filter","title":"<code>tablite.core.Table.filter(expressions, filter_type='all', tqdm=_tqdm)</code>","text":"<p>enables filtering across columns for multiple criteria.</p> <p>expressions:</p> <pre><code>str: Expression that can be compiled and executed row by row.\n    exampLe: \"all((A==B and C!=4 and 200&lt;D))\"\n\nlist of dicts: (example):\n\n    L = [\n        {'column1':'A', 'criteria': \"==\", 'column2': 'B'},\n        {'column1':'C', 'criteria': \"!=\", \"value2\": '4'},\n        {'value1': 200, 'criteria': \"&lt;\", column2: 'D' }\n    ]\n\naccepted dictionary keys: 'column1', 'column2', 'criteria', 'value1', 'value2'\n</code></pre> <p>filter_type: 'all' or 'any'</p> Source code in <code>tablite/core.py</code> <pre><code>def filter(self, expressions, filter_type=\"all\", tqdm=_tqdm):\n    \"\"\"\n    enables filtering across columns for multiple criteria.\n\n    expressions:\n\n        str: Expression that can be compiled and executed row by row.\n            exampLe: \"all((A==B and C!=4 and 200&lt;D))\"\n\n        list of dicts: (example):\n\n            L = [\n                {'column1':'A', 'criteria': \"==\", 'column2': 'B'},\n                {'column1':'C', 'criteria': \"!=\", \"value2\": '4'},\n                {'value1': 200, 'criteria': \"&lt;\", column2: 'D' }\n            ]\n\n        accepted dictionary keys: 'column1', 'column2', 'criteria', 'value1', 'value2'\n\n    filter_type: 'all' or 'any'\n    \"\"\"\n    return redux.filter(self, expressions, filter_type, tqdm)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.sort_index","title":"<code>tablite.core.Table.sort_index(sort_mode='excel', tqdm=_tqdm, pbar=None, **kwargs)</code>","text":"<p>helper for methods <code>sort</code> and <code>is_sorted</code></p> <p>param: sort_mode: str: \"alphanumeric\", \"unix\", or, \"excel\" (default) param: **kwargs: sort criteria. See Table.sort()</p> Source code in <code>tablite/core.py</code> <pre><code>def sort_index(self, sort_mode=\"excel\", tqdm=_tqdm, pbar=None, **kwargs):\n    \"\"\"\n    helper for methods `sort` and `is_sorted`\n\n    param: sort_mode: str: \"alphanumeric\", \"unix\", or, \"excel\" (default)\n    param: **kwargs: sort criteria. See Table.sort()\n    \"\"\"\n    return sortation.sort_index(self, sort_mode, tqdm=tqdm, pbar=pbar, **kwargs)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.reindex","title":"<code>tablite.core.Table.reindex(index)</code>","text":"<p>index: list of integers that declare sort order.</p> <p>Examples:</p> <pre><code>Table:  ['a','b','c','d','e','f','g','h']\nindex:  [0,2,4,6]\nresult: ['b','d','f','h']\n\nTable:  ['a','b','c','d','e','f','g','h']\nindex:  [0,2,4,6,1,3,5,7]\nresult: ['a','c','e','g','b','d','f','h']\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>def reindex(self, index):\n    \"\"\"\n    index: list of integers that declare sort order.\n\n    Examples:\n\n        Table:  ['a','b','c','d','e','f','g','h']\n        index:  [0,2,4,6]\n        result: ['b','d','f','h']\n\n        Table:  ['a','b','c','d','e','f','g','h']\n        index:  [0,2,4,6,1,3,5,7]\n        result: ['a','c','e','g','b','d','f','h']\n\n    \"\"\"\n    if isinstance(index, list):\n        index = np.array(index)\n    return _reindex.reindex(self, index)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.drop_duplicates","title":"<code>tablite.core.Table.drop_duplicates(*args)</code>","text":"<p>removes duplicate rows based on column names</p> <p>args: (optional) column_names if no args, all columns are used.</p> Source code in <code>tablite/core.py</code> <pre><code>def drop_duplicates(self, *args):\n    \"\"\"\n    removes duplicate rows based on column names\n\n    args: (optional) column_names\n    if no args, all columns are used.\n    \"\"\"\n    if not args:\n        args = self.columns\n    index = self.unique_index(*args)\n    return self.reindex(index)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.sort","title":"<code>tablite.core.Table.sort(mapping, sort_mode='excel', tqdm=_tqdm, pbar: _tqdm = None)</code>","text":"<p>Perform multi-pass sorting with precedence given order of column names.</p> PARAMETER  DESCRIPTION <code>mapping</code> <p>keys as columns,             values as boolean for 'reverse'</p> <p> TYPE: <code>dict</code> </p> <code>sort_mode</code> <p>str: \"alphanumeric\", \"unix\", or, \"excel\"</p> <p> DEFAULT: <code>'excel'</code> </p> RETURNS DESCRIPTION <code>None</code> <p>Table.sort is sorted inplace</p> <p>Examples: Table.sort(mappinp={A':False}) means sort by 'A' in ascending order. Table.sort(mapping={'A':True, 'B':False}) means sort 'A' in descending order, then (2nd priority) sort B in ascending order.</p> Source code in <code>tablite/core.py</code> <pre><code>def sort(self, mapping, sort_mode=\"excel\", tqdm=_tqdm, pbar: _tqdm = None):\n    \"\"\"Perform multi-pass sorting with precedence given order of column names.\n\n    Args:\n        mapping (dict): keys as columns,\n                        values as boolean for 'reverse'\n        sort_mode: str: \"alphanumeric\", \"unix\", or, \"excel\"\n\n    Returns:\n        None: Table.sort is sorted inplace\n\n    Examples:\n    Table.sort(mappinp={A':False}) means sort by 'A' in ascending order.\n    Table.sort(mapping={'A':True, 'B':False}) means sort 'A' in descending order, then (2nd priority)\n    sort B in ascending order.\n    \"\"\"\n    new = sortation.sort(self, mapping, sort_mode, tqdm=tqdm, pbar=pbar)\n    self.columns = new.columns\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.sorted","title":"<code>tablite.core.Table.sorted(mapping, sort_mode='excel', tqdm=_tqdm, pbar: _tqdm = None)</code>","text":"<p>See sort. Sorted returns a new table in contrast to \"sort\", which is in-place.</p> RETURNS DESCRIPTION <p>Table.</p> Source code in <code>tablite/core.py</code> <pre><code>def sorted(self, mapping, sort_mode=\"excel\", tqdm=_tqdm, pbar: _tqdm = None):\n    \"\"\"See sort.\n    Sorted returns a new table in contrast to \"sort\", which is in-place.\n\n    Returns:\n        Table.\n    \"\"\"\n    return sortation.sort(self, mapping, sort_mode, tqdm=tqdm, pbar=pbar)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.is_sorted","title":"<code>tablite.core.Table.is_sorted(mapping, sort_mode='excel')</code>","text":"<p>Performs multi-pass sorting check with precedence given order of column names. **kwargs: optional: sort criteria. See Table.sort() :return bool</p> Source code in <code>tablite/core.py</code> <pre><code>def is_sorted(self, mapping, sort_mode=\"excel\"):\n    \"\"\"Performs multi-pass sorting check with precedence given order of column names.\n    **kwargs: optional: sort criteria. See Table.sort()\n    :return bool\n    \"\"\"\n    return sortation.is_sorted(self, mapping, sort_mode)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.any","title":"<code>tablite.core.Table.any(**kwargs)</code>","text":"<p>returns Table for rows where ANY kwargs match :param kwargs: dictionary with headers and values / boolean callable</p> Source code in <code>tablite/core.py</code> <pre><code>def any(self, **kwargs):\n    \"\"\"\n    returns Table for rows where ANY kwargs match\n    :param kwargs: dictionary with headers and values / boolean callable\n    \"\"\"\n    return redux.filter_any(self, **kwargs)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.all","title":"<code>tablite.core.Table.all(**kwargs)</code>","text":"<p>returns Table for rows where ALL kwargs match :param kwargs: dictionary with headers and values / boolean callable</p> <p>Examples:</p> <pre><code>t = Table()\nt['a'] = [1,2,3,4]\nt['b'] = [10,20,30,40]\n\ndef f(x):\n    return x == 4\ndef g(x):\n    return x &lt; 20\n\nt2 = t.any( **{\"a\":f, \"b\":g})\nassert [r for r in t2.rows] == [[1, 10], [4, 40]]\n\nt2 = t.any(a=f,b=g)\nassert [r for r in t2.rows] == [[1, 10], [4, 40]]\n\ndef h(x):\n    return x&gt;=2\n\ndef i(x):\n    return x&lt;=30\n\nt2 = t.all(a=h,b=i)\nassert [r for r in t2.rows] == [[2,20], [3, 30]]\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>def all(self, **kwargs):\n    \"\"\"\n    returns Table for rows where ALL kwargs match\n    :param kwargs: dictionary with headers and values / boolean callable\n\n    Examples:\n\n        t = Table()\n        t['a'] = [1,2,3,4]\n        t['b'] = [10,20,30,40]\n\n        def f(x):\n            return x == 4\n        def g(x):\n            return x &lt; 20\n\n        t2 = t.any( **{\"a\":f, \"b\":g})\n        assert [r for r in t2.rows] == [[1, 10], [4, 40]]\n\n        t2 = t.any(a=f,b=g)\n        assert [r for r in t2.rows] == [[1, 10], [4, 40]]\n\n        def h(x):\n            return x&gt;=2\n\n        def i(x):\n            return x&lt;=30\n\n        t2 = t.all(a=h,b=i)\n        assert [r for r in t2.rows] == [[2,20], [3, 30]]\n\n\n    \"\"\"\n    return redux.filter_all(self, **kwargs)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.drop","title":"<code>tablite.core.Table.drop(*args)</code>","text":"<p>removes all rows where args are present.</p> <p>Exmaple:</p> <p>t = Table() t['A'] = [1,2,3,None] t['B'] = [None,2,3,4] t2 = t.drop(None) t2'A', t2'B' ([2,3], [2,3])</p> Source code in <code>tablite/core.py</code> <pre><code>def drop(self, *args):\n    \"\"\"\n    removes all rows where args are present.\n\n    Exmaple:\n    &gt;&gt;&gt; t = Table()\n    &gt;&gt;&gt; t['A'] = [1,2,3,None]\n    &gt;&gt;&gt; t['B'] = [None,2,3,4]\n    &gt;&gt;&gt; t2 = t.drop(None)\n    &gt;&gt;&gt; t2['A'][:], t2['B'][:]\n    ([2,3], [2,3])\n\n    \"\"\"\n    if not args:\n        raise ValueError(\"What to drop? None? np.nan? \")\n    return redux.drop(self, *args)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.replace","title":"<code>tablite.core.Table.replace(mapping, columns=None, tqdm=_tqdm, pbar=None)</code>","text":"<p>replaces all mapped keys with values from named columns</p> PARAMETER  DESCRIPTION <code>mapping</code> <p>keys are targets for replacement,             values are replacements.</p> <p> TYPE: <code>dict</code> </p> <code>columns</code> <p>target columns. Defaults to None (all columns)</p> <p> TYPE: <code>list or str</code> DEFAULT: <code>None</code> </p> RAISES DESCRIPTION <code>ValueError</code> <p>description</p> Source code in <code>tablite/core.py</code> <pre><code>def replace(self, mapping, columns=None, tqdm=_tqdm, pbar=None):\n    \"\"\"replaces all mapped keys with values from named columns\n\n    Args:\n        mapping (dict): keys are targets for replacement,\n                        values are replacements.\n        columns (list or str, optional): target columns.\n            Defaults to None (all columns)\n\n    Raises:\n        ValueError: _description_\n    \"\"\"\n    if columns is None:\n        columns = list(self.columns)\n    if not isinstance(columns, list) and columns in self.columns:\n        columns = [columns]\n    type_check(columns, list)\n    for n in columns:\n        if n not in self.columns:\n            raise ValueError(f\"column not found: {n}\")\n\n    if pbar is None:\n        total = len(columns)\n        pbar = tqdm(total=total, desc=\"replace\", disable=Config.TQDM_DISABLE)\n\n    for name in columns:\n        col = self.columns[name]\n        col.replace(mapping)\n        pbar.update(1)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.groupby","title":"<code>tablite.core.Table.groupby(keys, functions, tqdm=_tqdm, pbar=None)</code>","text":"<p>keys: column names for grouping. functions: [optional] list of column names and group functions (See GroupyBy class) returns: table</p> <p>Example:</p> <pre><code>t = Table()\nt.add_column('A', data=[1, 1, 2, 2, 3, 3] * 2)\nt.add_column('B', data=[1, 2, 3, 4, 5, 6] * 2)\nt.add_column('C', data=[6, 5, 4, 3, 2, 1] * 2)\n\nt.show()\n+=====+=====+=====+\n|  A  |  B  |  C  |\n| int | int | int |\n+-----+-----+-----+\n|    1|    1|    6|\n|    1|    2|    5|\n|    2|    3|    4|\n|    2|    4|    3|\n|    3|    5|    2|\n|    3|    6|    1|\n|    1|    1|    6|\n|    1|    2|    5|\n|    2|    3|    4|\n|    2|    4|    3|\n|    3|    5|    2|\n|    3|    6|    1|\n+=====+=====+=====+\n\ng = t.groupby(keys=['A', 'C'], functions=[('B', gb.sum)])\ng.show()\n+===+===+===+======+\n| # | A | C |Sum(B)|\n|row|int|int| int  |\n+---+---+---+------+\n|0  |  1|  6|     2|\n|1  |  1|  5|     4|\n|2  |  2|  4|     6|\n|3  |  2|  3|     8|\n|4  |  3|  2|    10|\n|5  |  3|  1|    12|\n+===+===+===+======+\n</code></pre> <p>Cheat sheet:</p> <p>list of unique values</p> <pre><code>&gt;&gt;&gt; g1 = t.groupby(keys=['A'], functions=[])\n&gt;&gt;&gt; g1['A'][:]\n[1,2,3]\n</code></pre> <p>alternatively:</p> <p>t['A'].unique() [1,2,3]</p> <p>list of unique values, grouped by longest combination.</p> <pre><code>&gt;&gt;&gt; g2 = t.groupby(keys=['A', 'B'], functions=[])\n&gt;&gt;&gt; g2['A'][:], g2['B'][:]\n([1,1,2,2,3,3], [1,2,3,4,5,6])\n</code></pre> <p>alternatively:</p> <pre><code>&gt;&gt;&gt; list(zip(*t.index('A', 'B').keys()))\n[(1,1,2,2,3,3) (1,2,3,4,5,6)]\n</code></pre> <p>A key (unique values) and count hereof.</p> <pre><code>&gt;&gt;&gt; g3 = t.groupby(keys=['A'], functions=[('A', gb.count)])\n&gt;&gt;&gt; g3['A'][:], g3['Count(A)'][:]\n([1,2,3], [4,4,4])\n</code></pre> <p>alternatively:</p> <pre><code>&gt;&gt;&gt; t['A'].histogram()\n([1,2,3], [4,4,4])\n</code></pre> <p>for more exmaples see:     https://github.com/root-11/tablite/blob/master/tests/test_groupby.py</p> Source code in <code>tablite/core.py</code> <pre><code>def groupby(self, keys, functions, tqdm=_tqdm, pbar=None):\n    \"\"\"\n    keys: column names for grouping.\n    functions: [optional] list of column names and group functions (See GroupyBy class)\n    returns: table\n\n    Example:\n    ```\n    t = Table()\n    t.add_column('A', data=[1, 1, 2, 2, 3, 3] * 2)\n    t.add_column('B', data=[1, 2, 3, 4, 5, 6] * 2)\n    t.add_column('C', data=[6, 5, 4, 3, 2, 1] * 2)\n\n    t.show()\n    +=====+=====+=====+\n    |  A  |  B  |  C  |\n    | int | int | int |\n    +-----+-----+-----+\n    |    1|    1|    6|\n    |    1|    2|    5|\n    |    2|    3|    4|\n    |    2|    4|    3|\n    |    3|    5|    2|\n    |    3|    6|    1|\n    |    1|    1|    6|\n    |    1|    2|    5|\n    |    2|    3|    4|\n    |    2|    4|    3|\n    |    3|    5|    2|\n    |    3|    6|    1|\n    +=====+=====+=====+\n\n    g = t.groupby(keys=['A', 'C'], functions=[('B', gb.sum)])\n    g.show()\n    +===+===+===+======+\n    | # | A | C |Sum(B)|\n    |row|int|int| int  |\n    +---+---+---+------+\n    |0  |  1|  6|     2|\n    |1  |  1|  5|     4|\n    |2  |  2|  4|     6|\n    |3  |  2|  3|     8|\n    |4  |  3|  2|    10|\n    |5  |  3|  1|    12|\n    +===+===+===+======+\n    ```\n    Cheat sheet:\n\n    list of unique values\n    ```\n    &gt;&gt;&gt; g1 = t.groupby(keys=['A'], functions=[])\n    &gt;&gt;&gt; g1['A'][:]\n    [1,2,3]\n    ```\n    alternatively:\n    &gt;&gt;&gt; t['A'].unique()\n    [1,2,3]\n\n    list of unique values, grouped by longest combination.\n    ```\n    &gt;&gt;&gt; g2 = t.groupby(keys=['A', 'B'], functions=[])\n    &gt;&gt;&gt; g2['A'][:], g2['B'][:]\n    ([1,1,2,2,3,3], [1,2,3,4,5,6])\n    ```\n    alternatively:\n    ```\n    &gt;&gt;&gt; list(zip(*t.index('A', 'B').keys()))\n    [(1,1,2,2,3,3) (1,2,3,4,5,6)]\n    ```\n    A key (unique values) and count hereof.\n    ```\n    &gt;&gt;&gt; g3 = t.groupby(keys=['A'], functions=[('A', gb.count)])\n    &gt;&gt;&gt; g3['A'][:], g3['Count(A)'][:]\n    ([1,2,3], [4,4,4])\n    ```\n    alternatively:\n    ```\n    &gt;&gt;&gt; t['A'].histogram()\n    ([1,2,3], [4,4,4])\n    ```\n    for more exmaples see:\n        https://github.com/root-11/tablite/blob/master/tests/test_groupby.py\n\n    \"\"\"\n    return _groupby(self, keys, functions, tqdm)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.pivot","title":"<code>tablite.core.Table.pivot(rows, columns, functions, values_as_rows=True, tqdm=_tqdm, pbar=None)</code>","text":"<p>param: rows: column names to keep as rows param: columns: column names to keep as columns param: functions: aggregation functions from the Groupby class as</p> <p>example:</p> <pre><code>t.show()\n+=====+=====+=====+\n|  A  |  B  |  C  |\n| int | int | int |\n+-----+-----+-----+\n|    1|    1|    6|\n|    1|    2|    5|\n|    2|    3|    4|\n|    2|    4|    3|\n|    3|    5|    2|\n|    3|    6|    1|\n|    1|    1|    6|\n|    1|    2|    5|\n|    2|    3|    4|\n|    2|    4|    3|\n|    3|    5|    2|\n|    3|    6|    1|\n+=====+=====+=====+\n\nt2 = t.pivot(rows=['C'], columns=['A'], functions=[('B', gb.sum)])\nt2.show()\n+===+===+========+=====+=====+=====+\n| # | C |function|(A=1)|(A=2)|(A=3)|\n|row|int|  str   |mixed|mixed|mixed|\n+---+---+--------+-----+-----+-----+\n|0  |  6|Sum(B)  |    2|None |None |\n|1  |  5|Sum(B)  |    4|None |None |\n|2  |  4|Sum(B)  |None |    6|None |\n|3  |  3|Sum(B)  |None |    8|None |\n|4  |  2|Sum(B)  |None |None |   10|\n|5  |  1|Sum(B)  |None |None |   12|\n+===+===+========+=====+=====+=====+\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>def pivot(self, rows, columns, functions, values_as_rows=True, tqdm=_tqdm, pbar=None):\n    \"\"\"\n    param: rows: column names to keep as rows\n    param: columns: column names to keep as columns\n    param: functions: aggregation functions from the Groupby class as\n\n    example:\n    ```\n    t.show()\n    +=====+=====+=====+\n    |  A  |  B  |  C  |\n    | int | int | int |\n    +-----+-----+-----+\n    |    1|    1|    6|\n    |    1|    2|    5|\n    |    2|    3|    4|\n    |    2|    4|    3|\n    |    3|    5|    2|\n    |    3|    6|    1|\n    |    1|    1|    6|\n    |    1|    2|    5|\n    |    2|    3|    4|\n    |    2|    4|    3|\n    |    3|    5|    2|\n    |    3|    6|    1|\n    +=====+=====+=====+\n\n    t2 = t.pivot(rows=['C'], columns=['A'], functions=[('B', gb.sum)])\n    t2.show()\n    +===+===+========+=====+=====+=====+\n    | # | C |function|(A=1)|(A=2)|(A=3)|\n    |row|int|  str   |mixed|mixed|mixed|\n    +---+---+--------+-----+-----+-----+\n    |0  |  6|Sum(B)  |    2|None |None |\n    |1  |  5|Sum(B)  |    4|None |None |\n    |2  |  4|Sum(B)  |None |    6|None |\n    |3  |  3|Sum(B)  |None |    8|None |\n    |4  |  2|Sum(B)  |None |None |   10|\n    |5  |  1|Sum(B)  |None |None |   12|\n    +===+===+========+=====+=====+=====+\n    ```\n    \"\"\"\n    return pivots.pivot(self, rows, columns, functions, values_as_rows, tqdm=tqdm, pbar=pbar)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.merge","title":"<code>tablite.core.Table.merge(left, right, new, criteria)</code>","text":"<p>takes from LEFT where criteria is True else RIGHT. :param: T: Table :param: criteria: np.array(bool):          if True take left column         else take right column :param left: (str) column name :param right: (str) column name :param new: (str) new name</p> <p>:returns: T</p> <p>Example:</p> <pre><code>&gt;&gt;&gt; c.show()\n+==+====+====+====+====+\n| #| A  | B  | C  | D  |\n+--+----+----+----+----+\n| 0|   1|  10|   1|  11|\n| 1|   2|  20|   2|  12|\n| 2|   3|None|   3|  13|\n| 3|None|  40|None|None|\n| 4|   5|  50|None|None|\n| 5|None|None|   6|  16|\n| 6|None|None|   7|  17|\n+==+====+====+====+====+\n\n&gt;&gt;&gt; c.merge(\"A\", \"C\", new=\"E\", criteria=[v != None for v in c['A']])\n&gt;&gt;&gt; c.show()\n+==+====+====+====+\n| #| B  | D  | E  |\n+--+----+----+----+\n| 0|  10|  11|   1|\n| 1|  20|  12|   2|\n| 2|None|  13|   3|\n| 3|  40|None|None|\n| 4|  50|None|   5|\n| 5|None|  16|   6|\n| 6|None|  17|   7|\n+==+====+====+====+\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>def merge(self, left, right, new, criteria):\n    \"\"\" takes from LEFT where criteria is True else RIGHT.\n    :param: T: Table\n    :param: criteria: np.array(bool): \n            if True take left column\n            else take right column\n    :param left: (str) column name\n    :param right: (str) column name\n    :param new: (str) new name\n\n    :returns: T\n\n    Example:\n    ```\n    &gt;&gt;&gt; c.show()\n    +==+====+====+====+====+\n    | #| A  | B  | C  | D  |\n    +--+----+----+----+----+\n    | 0|   1|  10|   1|  11|\n    | 1|   2|  20|   2|  12|\n    | 2|   3|None|   3|  13|\n    | 3|None|  40|None|None|\n    | 4|   5|  50|None|None|\n    | 5|None|None|   6|  16|\n    | 6|None|None|   7|  17|\n    +==+====+====+====+====+\n\n    &gt;&gt;&gt; c.merge(\"A\", \"C\", new=\"E\", criteria=[v != None for v in c['A']])\n    &gt;&gt;&gt; c.show()\n    +==+====+====+====+\n    | #| B  | D  | E  |\n    +--+----+----+----+\n    | 0|  10|  11|   1|\n    | 1|  20|  12|   2|\n    | 2|None|  13|   3|\n    | 3|  40|None|None|\n    | 4|  50|None|   5|\n    | 5|None|  16|   6|\n    | 6|None|  17|   7|\n    +==+====+====+====+\n    ```\n    \"\"\"\n    return merge.where(self, criteria,left,right,new)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.column_select","title":"<code>tablite.core.Table.column_select(cols: list[ColumnSelectorDict], tqdm=_tqdm, TaskManager=_TaskManager)</code>","text":"<p>type-casts columns from a given table to specified type(s)</p> cols <p>list of dicts: (example):</p> <pre><code>cols = [\n    {'column':'A', 'type': 'bool'},\n    {'column':'B', 'type': 'int', 'allow_empty': True},\n    {'column':'B', 'type': 'float', 'allow_empty': False, 'rename': 'C'},\n]\n</code></pre> <p>'column'     : column name of the input table that we want to type-cast 'type'       : type that we want to type-cast the specified column to 'allow_empty': should we allow empty values (None, str('')) through (Default: False) 'rename'     : new name of the column, if None will keep the original name, in case of duplicates suffix will be added (Default: None)</p> <p>supported types: 'bool', 'int', 'float', 'str', 'date', 'time', 'datetime'</p> <p>if any of the columns is rejected, entire row is rejected</p> <p>tqdm: progressbar constructor TaskManager: TaskManager constructor</p> (TABLE, TABLE) DESCRIPTION <p>first table contains the rows that were successfully cast to desired types</p> <p>second table contains rows that failed to cast + rejection reason</p> Source code in <code>tablite/core.py</code> <pre><code>def column_select(self, cols: list[ColumnSelectorDict], tqdm=_tqdm, TaskManager=_TaskManager):\n    \"\"\"\n    type-casts columns from a given table to specified type(s)\n\n    cols:\n        list of dicts: (example):\n\n            cols = [\n                {'column':'A', 'type': 'bool'},\n                {'column':'B', 'type': 'int', 'allow_empty': True},\n                {'column':'B', 'type': 'float', 'allow_empty': False, 'rename': 'C'},\n            ]\n\n        'column'     : column name of the input table that we want to type-cast\n        'type'       : type that we want to type-cast the specified column to\n        'allow_empty': should we allow empty values (None, str('')) through (Default: False)\n        'rename'     : new name of the column, if None will keep the original name, in case of duplicates suffix will be added (Default: None)\n\n        supported types: 'bool', 'int', 'float', 'str', 'date', 'time', 'datetime'\n\n        if any of the columns is rejected, entire row is rejected\n\n    tqdm: progressbar constructor\n    TaskManager: TaskManager constructor\n\n    returns: (Table, Table)\n        first table contains the rows that were successfully cast to desired types\n        second table contains rows that failed to cast + rejection reason\n    \"\"\"\n    return _column_select(self, cols, tqdm, TaskManager)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.join","title":"<code>tablite.core.Table.join(other, left_keys, right_keys, left_columns=None, right_columns=None, kind='inner', merge_keys=False, tqdm=_tqdm, pbar=None)</code>","text":"<p>short-cut for all join functions. kind: 'inner', 'left', 'outer', 'cross'</p> Source code in <code>tablite/core.py</code> <pre><code>def join(self, other, left_keys, right_keys, left_columns=None, right_columns=None, kind=\"inner\", merge_keys=False, tqdm=_tqdm, pbar=None):\n    \"\"\"\n    short-cut for all join functions.\n    kind: 'inner', 'left', 'outer', 'cross'\n    \"\"\"\n    kinds = {\n        \"inner\": self.inner_join,\n        \"left\": self.left_join,\n        \"outer\": self.outer_join,\n        \"cross\": self.cross_join,\n    }\n    if kind not in kinds:\n        raise ValueError(f\"join type unknown: {kind}\")\n    f = kinds.get(kind, None)\n    return f(other, left_keys, right_keys, left_columns, right_columns, merge_keys=merge_keys, tqdm=tqdm, pbar=pbar)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.left_join","title":"<code>tablite.core.Table.left_join(other, left_keys, right_keys, left_columns=None, right_columns=None, merge_keys=False, tqdm=_tqdm, pbar=None)</code>","text":"<p>:param other: self, other = (left, right) :param left_keys: list of keys for the join :param right_keys: list of keys for the join :param left_columns: list of left columns to retain, if None, all are retained. :param right_columns: list of right columns to retain, if None, all are retained. :return: new Table Example:</p> <pre><code>SQL:   SELECT number, letter FROM numbers LEFT JOIN letters ON numbers.colour == letters.color\nTablite: left_join = numbers.left_join(\n    letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter']\n)\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>def left_join(self, other, left_keys, right_keys, left_columns=None, right_columns=None, merge_keys=False, tqdm=_tqdm, pbar=None):\n    \"\"\"\n    :param other: self, other = (left, right)\n    :param left_keys: list of keys for the join\n    :param right_keys: list of keys for the join\n    :param left_columns: list of left columns to retain, if None, all are retained.\n    :param right_columns: list of right columns to retain, if None, all are retained.\n    :return: new Table\n    Example:\n    ```\n    SQL:   SELECT number, letter FROM numbers LEFT JOIN letters ON numbers.colour == letters.color\n    Tablite: left_join = numbers.left_join(\n        letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter']\n    )\n    ```\n    \"\"\"\n    return joins.left_join(self, other, left_keys, right_keys, left_columns, right_columns, merge_keys=merge_keys, tqdm=tqdm, pbar=pbar)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.inner_join","title":"<code>tablite.core.Table.inner_join(other, left_keys, right_keys, left_columns=None, right_columns=None, merge_keys=False, tqdm=_tqdm, pbar=None)</code>","text":"<p>:param other: self, other = (left, right) :param left_keys: list of keys for the join :param right_keys: list of keys for the join :param left_columns: list of left columns to retain, if None, all are retained. :param right_columns: list of right columns to retain, if None, all are retained. :return: new Table Example:</p> <pre><code>SQL:   SELECT number, letter FROM numbers JOIN letters ON numbers.colour == letters.color\nTablite: inner_join = numbers.inner_join(\n    letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter']\n    )\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>def inner_join(self, other, left_keys, right_keys, left_columns=None, right_columns=None, merge_keys=False, tqdm=_tqdm, pbar=None):\n    \"\"\"\n    :param other: self, other = (left, right)\n    :param left_keys: list of keys for the join\n    :param right_keys: list of keys for the join\n    :param left_columns: list of left columns to retain, if None, all are retained.\n    :param right_columns: list of right columns to retain, if None, all are retained.\n    :return: new Table\n    Example:\n    ```\n    SQL:   SELECT number, letter FROM numbers JOIN letters ON numbers.colour == letters.color\n    Tablite: inner_join = numbers.inner_join(\n        letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter']\n        )\n    ```\n    \"\"\"\n    return joins.inner_join(self, other, left_keys, right_keys, left_columns, right_columns, merge_keys=merge_keys, tqdm=tqdm, pbar=pbar)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.outer_join","title":"<code>tablite.core.Table.outer_join(other, left_keys, right_keys, left_columns=None, right_columns=None, merge_keys=False, tqdm=_tqdm, pbar=None)</code>","text":"<p>:param other: self, other = (left, right) :param left_keys: list of keys for the join :param right_keys: list of keys for the join :param left_columns: list of left columns to retain, if None, all are retained. :param right_columns: list of right columns to retain, if None, all are retained. :return: new Table Example:</p> <pre><code>SQL:   SELECT number, letter FROM numbers OUTER JOIN letters ON numbers.colour == letters.color\nTablite: outer_join = numbers.outer_join(\n    letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter']\n    )\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>def outer_join(self, other, left_keys, right_keys, left_columns=None, right_columns=None, merge_keys=False, tqdm=_tqdm, pbar=None):\n    \"\"\"\n    :param other: self, other = (left, right)\n    :param left_keys: list of keys for the join\n    :param right_keys: list of keys for the join\n    :param left_columns: list of left columns to retain, if None, all are retained.\n    :param right_columns: list of right columns to retain, if None, all are retained.\n    :return: new Table\n    Example:\n    ```\n    SQL:   SELECT number, letter FROM numbers OUTER JOIN letters ON numbers.colour == letters.color\n    Tablite: outer_join = numbers.outer_join(\n        letters, left_keys=['colour'], right_keys=['color'], left_columns=['number'], right_columns=['letter']\n        )\n    ```\n    \"\"\"\n    return joins.outer_join(self, other, left_keys, right_keys, left_columns, right_columns, merge_keys=merge_keys, tqdm=tqdm, pbar=pbar)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.cross_join","title":"<code>tablite.core.Table.cross_join(other, left_keys, right_keys, left_columns=None, right_columns=None, merge_keys=False, tqdm=_tqdm, pbar=None)</code>","text":"<p>CROSS JOIN returns the Cartesian product of rows from tables in the join. In other words, it will produce rows which combine each row from the first table with each row from the second table</p> Source code in <code>tablite/core.py</code> <pre><code>def cross_join(self, other, left_keys, right_keys, left_columns=None, right_columns=None, merge_keys=False, tqdm=_tqdm, pbar=None):\n    \"\"\"\n    CROSS JOIN returns the Cartesian product of rows from tables in the join.\n    In other words, it will produce rows which combine each row from the first table\n    with each row from the second table\n    \"\"\"\n    return joins.cross_join(self, other, left_keys, right_keys, left_columns, right_columns, merge_keys=merge_keys, tqdm=tqdm, pbar=pbar)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.lookup","title":"<code>tablite.core.Table.lookup(other, *criteria, all=True, tqdm=_tqdm)</code>","text":"<p>function for looking up values in <code>other</code> according to criteria in ascending order. :param: other: Table sorted in ascending search order. :param: criteria: Each criteria must be a tuple with value comparisons in the form:     (LEFT, OPERATOR, RIGHT) :param: all: boolean: True=ALL, False=Any</p> <p>OPERATOR must be a callable that returns a boolean LEFT must be a value that the OPERATOR can compare. RIGHT must be a value that the OPERATOR can compare.</p> <p>Examples:</p> <pre><code>('column A', \"==\", 'column B')  # comparison of two columns\n('Date', \"&lt;\", DataTypes.date(24,12) )  # value from column 'Date' is before 24/12.\nf = lambda L,R: all( ord(L) &lt; ord(R) )  # uses custom function.\n('text 1', f, 'text 2') value from column 'text 1' is compared with value from column 'text 2'\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>def lookup(self, other, *criteria, all=True, tqdm=_tqdm):\n    \"\"\"function for looking up values in `other` according to criteria in ascending order.\n    :param: other: Table sorted in ascending search order.\n    :param: criteria: Each criteria must be a tuple with value comparisons in the form:\n        (LEFT, OPERATOR, RIGHT)\n    :param: all: boolean: True=ALL, False=Any\n\n    OPERATOR must be a callable that returns a boolean\n    LEFT must be a value that the OPERATOR can compare.\n    RIGHT must be a value that the OPERATOR can compare.\n\n    Examples:\n    ```\n    ('column A', \"==\", 'column B')  # comparison of two columns\n    ('Date', \"&lt;\", DataTypes.date(24,12) )  # value from column 'Date' is before 24/12.\n    f = lambda L,R: all( ord(L) &lt; ord(R) )  # uses custom function.\n    ('text 1', f, 'text 2') value from column 'text 1' is compared with value from column 'text 2'\n    ```\n    \"\"\"\n    return lookup.lookup(self, other, *criteria, all=all, tqdm=tqdm)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.match","title":"<code>tablite.core.Table.match(other, *criteria, keep_left=None, keep_right=None)</code>","text":"<p>performs inner join where <code>T</code> matches <code>other</code> and removes rows that do not match.</p> <p>:param: T: Table :param: other: Table :param: criteria: Each criteria must be a tuple with value comparisons in the form:</p> <pre><code>(LEFT, OPERATOR, RIGHT), where operator must be \"==\"\n\nExample:\n    ('column A', \"==\", 'column B')\n\nThis syntax follows the lookup syntax. See Lookup for details.\n</code></pre> <p>:param: keep_left: list of columns to keep. :param: keep_right: list of right columns to keep.</p> Source code in <code>tablite/core.py</code> <pre><code>def match(self, other, *criteria, keep_left=None, keep_right=None):\n    \"\"\"\n    performs inner join where `T` matches `other` and removes rows that do not match.\n\n    :param: T: Table\n    :param: other: Table\n    :param: criteria: Each criteria must be a tuple with value comparisons in the form:\n\n        (LEFT, OPERATOR, RIGHT), where operator must be \"==\"\n\n        Example:\n            ('column A', \"==\", 'column B')\n\n        This syntax follows the lookup syntax. See Lookup for details.\n\n    :param: keep_left: list of columns to keep.\n    :param: keep_right: list of right columns to keep.\n    \"\"\"\n    return match.match(self, other, *criteria, keep_left=keep_left, keep_right=keep_right)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.replace_missing_values","title":"<code>tablite.core.Table.replace_missing_values(*args, **kwargs)</code>","text":"Source code in <code>tablite/core.py</code> <pre><code>def replace_missing_values(self, *args, **kwargs):\n    raise AttributeError(\"See imputation\")\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.imputation","title":"<code>tablite.core.Table.imputation(targets, missing=None, method='carry forward', sources=None, tqdm=_tqdm)</code>","text":"<p>In statistics, imputation is the process of replacing missing data with substituted values.</p> <p>See more: https://en.wikipedia.org/wiki/Imputation_(statistics)</p> PARAMETER  DESCRIPTION <code>table</code> <p>source table.</p> <p> TYPE: <code>Table</code> </p> <code>targets</code> <p>column names to find and replace missing values</p> <p> TYPE: <code>str or list of strings</code> </p> <code>missing</code> <p>values to be replaced.</p> <p> TYPE: <code>None or iterable</code> DEFAULT: <code>None</code> </p> <code>method</code> <p>method to be used for replacement. Options:</p> <p>'carry forward':     takes the previous value, and carries forward into fields     where values are missing.     +: quick. Realistic on time series.     -: Can produce strange outliers.</p> <p>'mean':     calculates the column mean (exclude <code>missing</code>) and copies     the mean in as replacement.     +: quick     -: doesn't work on text. Causes data set to drift towards the mean.</p> <p>'mode':     calculates the column mode (exclude <code>missing</code>) and copies     the mean in as replacement.     +: quick     -: most frequent value becomes over-represented in the sample</p> <p>'nearest neighbour':     calculates normalised distance between items in source columns     selects nearest neighbour and copies value as replacement.     +: works for any datatype.     -: computationally intensive (e.g. slow)</p> <p> TYPE: <code>str</code> DEFAULT: <code>'carry forward'</code> </p> <code>sources</code> <p>NEAREST NEIGHBOUR ONLY column names to be used during imputation. if None or empty, all columns will be used.</p> <p> TYPE: <code>list of strings</code> DEFAULT: <code>None</code> </p> RETURNS DESCRIPTION <code>table</code> <p>table with replaced values.</p> Source code in <code>tablite/core.py</code> <pre><code>def imputation(self, targets, missing=None, method=\"carry forward\", sources=None, tqdm=_tqdm):\n    \"\"\"\n    In statistics, imputation is the process of replacing missing data with substituted values.\n\n    See more: https://en.wikipedia.org/wiki/Imputation_(statistics)\n\n    Args:\n        table (Table): source table.\n\n        targets (str or list of strings): column names to find and\n            replace missing values\n\n        missing (None or iterable): values to be replaced.\n\n        method (str): method to be used for replacement. Options:\n\n            'carry forward':\n                takes the previous value, and carries forward into fields\n                where values are missing.\n                +: quick. Realistic on time series.\n                -: Can produce strange outliers.\n\n            'mean':\n                calculates the column mean (exclude `missing`) and copies\n                the mean in as replacement.\n                +: quick\n                -: doesn't work on text. Causes data set to drift towards the mean.\n\n            'mode':\n                calculates the column mode (exclude `missing`) and copies\n                the mean in as replacement.\n                +: quick\n                -: most frequent value becomes over-represented in the sample\n\n            'nearest neighbour':\n                calculates normalised distance between items in source columns\n                selects nearest neighbour and copies value as replacement.\n                +: works for any datatype.\n                -: computationally intensive (e.g. slow)\n\n        sources (list of strings): NEAREST NEIGHBOUR ONLY\n            column names to be used during imputation.\n            if None or empty, all columns will be used.\n\n    Returns:\n        table: table with replaced values.\n    \"\"\"\n    return imputation.imputation(self, targets, missing, method, sources, tqdm=tqdm)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.transpose","title":"<code>tablite.core.Table.transpose(tqdm=_tqdm)</code>","text":"Source code in <code>tablite/core.py</code> <pre><code>def transpose(self, tqdm=_tqdm):\n    return pivots.transpose(self, tqdm)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.pivot_transpose","title":"<code>tablite.core.Table.pivot_transpose(columns, keep=None, column_name='transpose', value_name='value', tqdm=_tqdm)</code>","text":"<p>Transpose a selection of columns to rows.</p> PARAMETER  DESCRIPTION <code>columns</code> <p>column names to transpose</p> <p> TYPE: <code>list of column names</code> </p> <code>keep</code> <p>column names to keep (repeat)</p> <p> TYPE: <code>list of column names</code> DEFAULT: <code>None</code> </p> RETURNS DESCRIPTION <code>Table</code> <p>with columns transposed to rows</p> Example <p>transpose columns 1,2 and 3 and transpose the remaining columns, except <code>sum</code>.</p> <p>Input:</p> <pre><code>| col1 | col2 | col3 | sun | mon | tue | ... | sat | sum  |\n|------|------|------|-----|-----|-----|-----|-----|------|\n| 1234 | 2345 | 3456 | 456 | 567 |     | ... |     | 1023 |\n| 1244 | 2445 | 4456 |     |   7 |     | ... |     |    7 |\n| ...  |      |      |     |     |     |     |     |      |\n\nt.transpose(keep=[col1, col2, col3], transpose=[sun,mon,tue,wed,thu,fri,sat])`\n\nOutput:\n\n|col1| col2| col3| transpose| value|\n|----|-----|-----|----------|------|\n|1234| 2345| 3456| sun      |   456|\n|1234| 2345| 3456| mon      |   567|\n|1244| 2445| 4456| mon      |     7|\n</code></pre> Source code in <code>tablite/core.py</code> <pre><code>def pivot_transpose(self, columns, keep=None, column_name=\"transpose\", value_name=\"value\", tqdm=_tqdm):\n    \"\"\"Transpose a selection of columns to rows.\n\n    Args:\n        columns (list of column names): column names to transpose\n        keep (list of column names): column names to keep (repeat)\n\n    Returns:\n        Table: with columns transposed to rows\n\n    Example:\n        transpose columns 1,2 and 3 and transpose the remaining columns, except `sum`.\n\n    Input:\n    ```\n    | col1 | col2 | col3 | sun | mon | tue | ... | sat | sum  |\n    |------|------|------|-----|-----|-----|-----|-----|------|\n    | 1234 | 2345 | 3456 | 456 | 567 |     | ... |     | 1023 |\n    | 1244 | 2445 | 4456 |     |   7 |     | ... |     |    7 |\n    | ...  |      |      |     |     |     |     |     |      |\n\n    t.transpose(keep=[col1, col2, col3], transpose=[sun,mon,tue,wed,thu,fri,sat])`\n\n    Output:\n\n    |col1| col2| col3| transpose| value|\n    |----|-----|-----|----------|------|\n    |1234| 2345| 3456| sun      |   456|\n    |1234| 2345| 3456| mon      |   567|\n    |1244| 2445| 4456| mon      |     7|\n    ```\n    \"\"\"\n    return pivots.pivot_transpose(self, columns, keep, column_name, value_name, tqdm=tqdm)\n</code></pre>"},{"location":"reference/core/#tablite.core.Table.diff","title":"<code>tablite.core.Table.diff(other, columns=None)</code>","text":"<p>compares table self with table other</p> PARAMETER  DESCRIPTION <code>self</code> <p>Table</p> <p> TYPE: <code>Table</code> </p> <code>other</code> <p>Table</p> <p> TYPE: <code>Table</code> </p> <code>columns</code> <p>list of column names to include in comparison. Defaults to None.</p> <p> TYPE: <code>List</code> DEFAULT: <code>None</code> </p> RETURNS DESCRIPTION <code>Table</code> <p>diff of self and other with diff in columns 1st and 2nd.</p> Source code in <code>tablite/core.py</code> <pre><code>def diff(self, other, columns=None):\n    \"\"\"compares table self with table other\n\n    Args:\n        self (Table): Table\n        other (Table): Table\n        columns (List, optional): list of column names to include in comparison. Defaults to None.\n\n    Returns:\n        Table: diff of self and other with diff in columns 1st and 2nd.\n    \"\"\"\n    return diff.diff(self, other, columns)\n</code></pre>"},{"location":"reference/core/#tablite.core-functions","title":"Functions","text":""},{"location":"reference/core/#tablite.core-modules","title":"Modules","text":""},{"location":"reference/datasets/","title":"Datasets","text":""},{"location":"reference/datasets/#tablite.datasets","title":"<code>tablite.datasets</code>","text":""},{"location":"reference/datasets/#tablite.datasets-classes","title":"Classes","text":""},{"location":"reference/datasets/#tablite.datasets-functions","title":"Functions","text":""},{"location":"reference/datasets/#tablite.datasets.synthetic_order_data","title":"<code>tablite.datasets.synthetic_order_data(rows=100000)</code>","text":"<p>Creates a synthetic dataset for testing that looks like this: (depending on number of rows)</p> <pre><code>+=========+=======+=============+===================+=====+===+=====+====+===+=====+=====+===================+==================+\n|    ~    |   #   |      1      |         2         |  3  | 4 |  5  | 6  | 7 |  8  |  9  |         10        |        11        |\n|   row   |  int  |     int     |      datetime     | int |int| int |str |str|mixed|mixed|       float       |      float       |\n+---------+-------+-------------+-------------------+-----+---+-----+----+---+-----+-----+-------------------+------------------+\n|0        |      1|1478158906743|2021-10-27 00:00:00|50764|  1|29990|C4-5|APP|21\u00b0  |None | 2.0434376837650046|1.3371665497020444|\n|1        |      2|2271295805011|2021-09-13 00:00:00|50141|  0|10212|C4-5|TAE|None |None |  1.010318612835485| 20.94821610676901|\n|2        |      3|1598726492913|2021-08-19 00:00:00|50527|  0|19416|C3-5|QPV|21\u00b0  |None |  1.463459515469516|  17.4133659842749|\n|3        |      4|1413615572689|2021-11-05 00:00:00|50181|  1|18637|C4-2|GCL|6\u00b0   |ABC  |  2.084002469706324| 0.489481411683505|\n|4        |      5| 245266998048|2021-09-25 00:00:00|50378|  0|29756|C5-4|LGY|6\u00b0   |XYZ  | 0.5141579343276079| 8.550780816571438|\n|5        |      6| 947994853644|2021-10-14 00:00:00|50511|  0| 7890|C2-4|BET|0\u00b0   |XYZ  | 1.1725893606177542| 7.447314130260951|\n|6        |      7|2230693047809|2021-10-07 00:00:00|50987|  1|26742|C1-3|CFP|0\u00b0   |XYZ  | 1.0921267279498004|11.009210185311993|\n|...      |...    |...          |...                |...  |...|...  |... |...|...  |...  |...                |...               |\n|7,999,993|7999994|2047223556745|2021-09-03 00:00:00|50883|  1|15687|C3-1|RFR|None |XYZ  | 1.3467185981566827|17.023443485654845|\n|7,999,994|7999995|1814140654790|2021-08-02 00:00:00|50152|  0|16556|C4-2|WTC|None |ABC  | 1.1517593924478968| 8.201818634721487|\n|7,999,995|7999996| 155308171103|2021-10-14 00:00:00|50008|  1|14590|C1-3|WYM|0\u00b0   |None | 2.1273836233717978|23.295943554889195|\n|7,999,996|7999997|1620451532911|2021-12-12 00:00:00|50173|  1|20744|C2-1|ZYO|6\u00b0   |ABC  |  2.482509134693724| 22.25375464857266|\n|7,999,997|7999998|1248987682094|2021-12-20 00:00:00|50052|  1|28298|C5-4|XAW|None |XYZ  |0.17923757926558143|23.728160892974252|\n|7,999,998|7999999|1382206732187|2021-11-13 00:00:00|50993|  1|24832|C5-2|UDL|None |ABC  |0.08425329763360942|12.707735293126758|\n|7,999,999|8000000| 600688069780|2021-09-28 00:00:00|50510|  0|15819|C3-4|IGY|None |ABC  |  1.066241687256579|13.862069804070295|\n+=========+=======+=============+===================+=====+===+=====+====+===+=====+=====+===================+==================+\n</code></pre> PARAMETER  DESCRIPTION <code>rows</code> <p>number of rows wanted. Defaults to 100_000.</p> <p> TYPE: <code>int</code> DEFAULT: <code>100000</code> </p> RETURNS DESCRIPTION <code>Table</code> <p>Populated table.</p> <p> TYPE: <code>Table</code> </p> Source code in <code>tablite/datasets.py</code> <pre><code>def synthetic_order_data(rows=100_000):\n    \"\"\"Creates a synthetic dataset for testing that looks like this:\n    (depending on number of rows)\n\n    ```\n    +=========+=======+=============+===================+=====+===+=====+====+===+=====+=====+===================+==================+\n    |    ~    |   #   |      1      |         2         |  3  | 4 |  5  | 6  | 7 |  8  |  9  |         10        |        11        |\n    |   row   |  int  |     int     |      datetime     | int |int| int |str |str|mixed|mixed|       float       |      float       |\n    +---------+-------+-------------+-------------------+-----+---+-----+----+---+-----+-----+-------------------+------------------+\n    |0        |      1|1478158906743|2021-10-27 00:00:00|50764|  1|29990|C4-5|APP|21\u00b0  |None | 2.0434376837650046|1.3371665497020444|\n    |1        |      2|2271295805011|2021-09-13 00:00:00|50141|  0|10212|C4-5|TAE|None |None |  1.010318612835485| 20.94821610676901|\n    |2        |      3|1598726492913|2021-08-19 00:00:00|50527|  0|19416|C3-5|QPV|21\u00b0  |None |  1.463459515469516|  17.4133659842749|\n    |3        |      4|1413615572689|2021-11-05 00:00:00|50181|  1|18637|C4-2|GCL|6\u00b0   |ABC  |  2.084002469706324| 0.489481411683505|\n    |4        |      5| 245266998048|2021-09-25 00:00:00|50378|  0|29756|C5-4|LGY|6\u00b0   |XYZ  | 0.5141579343276079| 8.550780816571438|\n    |5        |      6| 947994853644|2021-10-14 00:00:00|50511|  0| 7890|C2-4|BET|0\u00b0   |XYZ  | 1.1725893606177542| 7.447314130260951|\n    |6        |      7|2230693047809|2021-10-07 00:00:00|50987|  1|26742|C1-3|CFP|0\u00b0   |XYZ  | 1.0921267279498004|11.009210185311993|\n    |...      |...    |...          |...                |...  |...|...  |... |...|...  |...  |...                |...               |\n    |7,999,993|7999994|2047223556745|2021-09-03 00:00:00|50883|  1|15687|C3-1|RFR|None |XYZ  | 1.3467185981566827|17.023443485654845|\n    |7,999,994|7999995|1814140654790|2021-08-02 00:00:00|50152|  0|16556|C4-2|WTC|None |ABC  | 1.1517593924478968| 8.201818634721487|\n    |7,999,995|7999996| 155308171103|2021-10-14 00:00:00|50008|  1|14590|C1-3|WYM|0\u00b0   |None | 2.1273836233717978|23.295943554889195|\n    |7,999,996|7999997|1620451532911|2021-12-12 00:00:00|50173|  1|20744|C2-1|ZYO|6\u00b0   |ABC  |  2.482509134693724| 22.25375464857266|\n    |7,999,997|7999998|1248987682094|2021-12-20 00:00:00|50052|  1|28298|C5-4|XAW|None |XYZ  |0.17923757926558143|23.728160892974252|\n    |7,999,998|7999999|1382206732187|2021-11-13 00:00:00|50993|  1|24832|C5-2|UDL|None |ABC  |0.08425329763360942|12.707735293126758|\n    |7,999,999|8000000| 600688069780|2021-09-28 00:00:00|50510|  0|15819|C3-4|IGY|None |ABC  |  1.066241687256579|13.862069804070295|\n    +=========+=======+=============+===================+=====+===+=====+====+===+=====+=====+===================+==================+\n    ```\n\n    Args:\n        rows (int, optional): number of rows wanted. Defaults to 100_000.\n\n    Returns:\n        Table (Table): Populated table.\n    \"\"\"  # noqa\n    rows = int(rows)\n\n    L1 = [\"None\", \"0\u00b0\", \"6\u00b0\", \"21\u00b0\"]\n    L2 = [\"ABC\", \"XYZ\", \"\"]\n\n    t = Table()\n    assert isinstance(t, Table)\n    for page_n in range(math.ceil(rows / Config.PAGE_SIZE)):  # n pages\n        start = (page_n * Config.PAGE_SIZE)\n        end = min(start + Config.PAGE_SIZE, rows)\n        ro = range(start, end)\n\n        t2 = Table()\n        t2[\"#\"] = [v+1 for v in ro]\n        # 1 - mock orderid\n        t2[\"1\"] = [random.randint(18_778_628_504, 2277_772_117_504) for i in ro]\n        # 2 - mock delivery date.\n        t2[\"2\"] = [datetime.fromordinal(random.randint(738000, 738150)).isoformat() for i in ro]\n        # 3 - mock store id.\n        t2[\"3\"] = [random.randint(50000, 51000) for _ in ro]\n        # 4 - random bit.\n        t2[\"4\"] = [random.randint(0, 1) for _ in ro]\n        # 5 - mock product id\n        t2[\"5\"] = [random.randint(3000, 30000) for _ in ro]\n        # 6 - random weird string\n        t2[\"6\"] = [f\"C{random.randint(1, 5)}-{random.randint(1, 5)}\" for _ in ro]\n        # 7 - # random category\n        t2[\"7\"] = [\"\".join(random.choice(ascii_uppercase) for _ in range(3)) for _ in ro]\n        # 8 -random temperature group.\n        t2[\"8\"] = [random.choice(L1) for _ in ro]\n        # 9 - random choice of category\n        t2[\"9\"] = [random.choice(L2) for _ in ro]\n        # 10 - volume?\n        t2[\"10\"] = [random.uniform(0.01, 2.5) for _ in ro]\n        # 11 - units?\n        t2[\"11\"] = [f\"{random.uniform(0.1, 25)}\" for _ in ro]\n\n        if len(t) == 0:\n            t = t2\n        else:\n            t += t2\n\n    return t\n</code></pre>"},{"location":"reference/datatypes/","title":"Datatypes","text":""},{"location":"reference/datatypes/#tablite.datatypes","title":"<code>tablite.datatypes</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes-attributes","title":"Attributes","text":""},{"location":"reference/datatypes/#tablite.datatypes.matched_types","title":"<code>tablite.datatypes.matched_types = {int: DataTypes._infer_int, str: DataTypes._infer_str, float: DataTypes._infer_float, bool: DataTypes._infer_bool, date: DataTypes._infer_date, datetime: DataTypes._infer_datetime, time: DataTypes._infer_time}</code>  <code>module-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes-classes","title":"Classes","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes","title":"<code>tablite.datatypes.DataTypes</code>","text":"<p>             Bases: <code>object</code></p> <p>DataTypes is the conversion library for all datatypes.</p> <p>It supports any / all python datatypes.</p>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes-attributes","title":"Attributes","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.int","title":"<code>tablite.datatypes.DataTypes.int = int</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.str","title":"<code>tablite.datatypes.DataTypes.str = str</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.float","title":"<code>tablite.datatypes.DataTypes.float = float</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.bool","title":"<code>tablite.datatypes.DataTypes.bool = bool</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.date","title":"<code>tablite.datatypes.DataTypes.date = date</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.datetime","title":"<code>tablite.datatypes.DataTypes.datetime = datetime</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.time","title":"<code>tablite.datatypes.DataTypes.time = time</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.timedelta","title":"<code>tablite.datatypes.DataTypes.timedelta = timedelta</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.numeric_types","title":"<code>tablite.datatypes.DataTypes.numeric_types = {int, float, date, time, datetime}</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.epoch","title":"<code>tablite.datatypes.DataTypes.epoch = datetime(2000, 1, 1, 0, 0, 0, 0, timezone.utc)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.epoch_no_tz","title":"<code>tablite.datatypes.DataTypes.epoch_no_tz = datetime(2000, 1, 1, 0, 0, 0, 0)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.digits","title":"<code>tablite.datatypes.DataTypes.digits = '1234567890'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.decimals","title":"<code>tablite.datatypes.DataTypes.decimals = set('1234567890-+eE.')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.integers","title":"<code>tablite.datatypes.DataTypes.integers = set('1234567890-+')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.nones","title":"<code>tablite.datatypes.DataTypes.nones = {'null', 'Null', 'NULL', '#N/A', '#n/a', '', 'None', None, np.nan}</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.none_type","title":"<code>tablite.datatypes.DataTypes.none_type = type(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.bytes_functions","title":"<code>tablite.datatypes.DataTypes.bytes_functions = {type(None): b_none, bool: b_bool, int: b_int, float: b_float, str: b_str, bytes: b_bytes, datetime: b_datetime, date: b_date, time: b_time, timedelta: b_timedelta}</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.type_code_functions","title":"<code>tablite.datatypes.DataTypes.type_code_functions = {1: _none, 2: _bool, 3: _int, 4: _float, 5: _str, 6: _bytes, 7: _datetime, 8: _date, 9: _time, 10: _timedelta, 11: _unpickle}</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.pytype_from_type_code","title":"<code>tablite.datatypes.DataTypes.pytype_from_type_code = {1: type(None), 2: bool, 3: int, 4: float, 5: str, 6: bytes, 7: datetime, 8: date, 9: time, 10: timedelta, 11: 'pickled object'}</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.date_formats","title":"<code>tablite.datatypes.DataTypes.date_formats = {'NNNN-NN-NN': lambda x: date(*int(i) for i in x.split('-')), 'NNNN-N-NN': lambda x: date(*int(i) for i in x.split('-')), 'NNNN-NN-N': lambda x: date(*int(i) for i in x.split('-')), 'NNNN-N-N': lambda x: date(*int(i) for i in x.split('-')), 'NN-NN-NNNN': lambda x: date(*[int(i) for i in x.split('-')][::-1]), 'N-NN-NNNN': lambda x: date(*[int(i) for i in x.split('-')][::-1]), 'NN-N-NNNN': lambda x: date(*[int(i) for i in x.split('-')][::-1]), 'N-N-NNNN': lambda x: date(*[int(i) for i in x.split('-')][::-1]), 'NNNN.NN.NN': lambda x: date(*int(i) for i in x.split('.')), 'NNNN.N.NN': lambda x: date(*int(i) for i in x.split('.')), 'NNNN.NN.N': lambda x: date(*int(i) for i in x.split('.')), 'NNNN.N.N': lambda x: date(*int(i) for i in x.split('.')), 'NN.NN.NNNN': lambda x: date(*[int(i) for i in x.split('.')][::-1]), 'N.NN.NNNN': lambda x: date(*[int(i) for i in x.split('.')][::-1]), 'NN.N.NNNN': lambda x: date(*[int(i) for i in x.split('.')][::-1]), 'N.N.NNNN': lambda x: date(*[int(i) for i in x.split('.')][::-1]), 'NNNN/NN/NN': lambda x: date(*int(i) for i in x.split('/')), 'NNNN/N/NN': lambda x: date(*int(i) for i in x.split('/')), 'NNNN/NN/N': lambda x: date(*int(i) for i in x.split('/')), 'NNNN/N/N': lambda x: date(*int(i) for i in x.split('/')), 'NN/NN/NNNN': lambda x: date(*[int(i) for i in x.split('/')][::-1]), 'N/NN/NNNN': lambda x: date(*[int(i) for i in x.split('/')][::-1]), 'NN/N/NNNN': lambda x: date(*[int(i) for i in x.split('/')][::-1]), 'N/N/NNNN': lambda x: date(*[int(i) for i in x.split('/')][::-1]), 'NNNN NN NN': lambda x: date(*int(i) for i in x.split(' ')), 'NNNN N NN': lambda x: date(*int(i) for i in x.split(' ')), 'NNNN NN N': lambda x: date(*int(i) for i in x.split(' ')), 'NNNN N N': lambda x: date(*int(i) for i in x.split(' ')), 'NN NN NNNN': lambda x: date(*[int(i) for i in x.split(' ')][::-1]), 'N N NNNN': lambda x: date(*[int(i) for i in x.split(' ')][::-1]), 'NN N NNNN': lambda x: date(*[int(i) for i in x.split(' ')][::-1]), 'N NN NNNN': lambda x: date(*[int(i) for i in x.split(' ')][::-1]), 'NNNNNNNN': lambda x: date(*(int(x[:4]), int(x[4:6]), int(x[6:])))}</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.datetime_formats","title":"<code>tablite.datatypes.DataTypes.datetime_formats = {'NNNN-NN-NNTNN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x), 'NNNN-NN-NNTNN:NN': lambda x: DataTypes.pattern_to_datetime(x), 'NNNN-NN-NN NN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, T=' '), 'NNNN-NN-NN NN:NN': lambda x: DataTypes.pattern_to_datetime(x, T=' '), 'NNNN/NN/NNTNN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/'), 'NNNN/NN/NNTNN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/'), 'NNNN/NN/NN NN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/', T=' '), 'NNNN/NN/NN NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/', T=' '), 'NNNN NN NNTNN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd=' '), 'NNNN NN NNTNN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd=' '), 'NNNN NN NN NN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd=' ', T=' '), 'NNNN NN NN NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd=' ', T=' '), 'NNNN.NN.NNTNN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='.'), 'NNNN.NN.NNTNN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='.'), 'NNNN.NN.NN NN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='.', T=' '), 'NNNN.NN.NN NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='.', T=' '), 'NN-NN-NNNNTNN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='-', T=' ', day_first=True), 'NN-NN-NNNNTNN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='-', T=' ', day_first=True), 'NN-NN-NNNN NN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='-', T=' ', day_first=True), 'NN-NN-NNNN NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='-', T=' ', day_first=True), 'NN/NN/NNNNTNN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/', day_first=True), 'NN/NN/NNNNTNN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/', day_first=True), 'NN/NN/NNNN NN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/', T=' ', day_first=True), 'NN/NN/NNNN NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/', T=' ', day_first=True), 'NN NN NNNNTNN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/', day_first=True), 'NN NN NNNNTNN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/', day_first=True), 'NN NN NNNN NN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/', day_first=True), 'NN NN NNNN NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='/', day_first=True), 'NN.NN.NNNNTNN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='.', day_first=True), 'NN.NN.NNNNTNN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='.', day_first=True), 'NN.NN.NNNN NN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='.', day_first=True), 'NN.NN.NNNN NN:NN': lambda x: DataTypes.pattern_to_datetime(x, ymd='.', day_first=True), 'NNNNNNNNTNNNNNN': lambda x: DataTypes.pattern_to_datetime(x, compact=1), 'NNNNNNNNTNNNN': lambda x: DataTypes.pattern_to_datetime(x, compact=1), 'NNNNNNNNTNN': lambda x: DataTypes.pattern_to_datetime(x, compact=1), 'NNNNNNNNNN': lambda x: DataTypes.pattern_to_datetime(x, compact=2), 'NNNNNNNNNNNN': lambda x: DataTypes.pattern_to_datetime(x, compact=2), 'NNNNNNNNNNNNNN': lambda x: DataTypes.pattern_to_datetime(x, compact=2), 'NNNNNNNNTNN:NN:NN': lambda x: DataTypes.pattern_to_datetime(x, compact=3)}</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.types","title":"<code>tablite.datatypes.DataTypes.types = [datetime, date, time, int, bool, float, str]</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes-functions","title":"Functions","text":""},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.type_code","title":"<code>tablite.datatypes.DataTypes.type_code(value)</code>  <code>classmethod</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>@classmethod\ndef type_code(cls, value):\n    if type(value) in cls._type_codes:\n        return cls._type_codes[type(value)]\n    elif hasattr(value, \"dtype\"):\n        dtype = pytype(value)\n        return cls._type_codes[dtype]\n    else:\n        return cls._type_codes[\"pickle\"]\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.b_none","title":"<code>tablite.datatypes.DataTypes.b_none(v)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def b_none(v):\n    return b\"None\"\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.b_bool","title":"<code>tablite.datatypes.DataTypes.b_bool(v)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def b_bool(v):\n    return bytes(str(v), encoding=\"utf-8\")\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.b_int","title":"<code>tablite.datatypes.DataTypes.b_int(v)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def b_int(v):\n    return bytes(str(v), encoding=\"utf-8\")\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.b_float","title":"<code>tablite.datatypes.DataTypes.b_float(v)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def b_float(v):\n    return bytes(str(v), encoding=\"utf-8\")\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.b_str","title":"<code>tablite.datatypes.DataTypes.b_str(v)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def b_str(v):\n    return v.encode(\"utf-8\")\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.b_bytes","title":"<code>tablite.datatypes.DataTypes.b_bytes(v)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def b_bytes(v):\n    return v\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.b_datetime","title":"<code>tablite.datatypes.DataTypes.b_datetime(v)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def b_datetime(v):\n    return bytes(v.isoformat(), encoding=\"utf-8\")\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.b_date","title":"<code>tablite.datatypes.DataTypes.b_date(v)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def b_date(v):\n    return bytes(v.isoformat(), encoding=\"utf-8\")\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.b_time","title":"<code>tablite.datatypes.DataTypes.b_time(v)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def b_time(v):\n    return bytes(v.isoformat(), encoding=\"utf-8\")\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.b_timedelta","title":"<code>tablite.datatypes.DataTypes.b_timedelta(v)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def b_timedelta(v):\n    return bytes(str(float(v.days + (v.seconds / (24 * 60 * 60)))), \"utf-8\")\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.b_pickle","title":"<code>tablite.datatypes.DataTypes.b_pickle(v)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def b_pickle(v):\n    return pickle.dumps(v, protocol=0)\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.to_bytes","title":"<code>tablite.datatypes.DataTypes.to_bytes(v)</code>  <code>classmethod</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>@classmethod\ndef to_bytes(cls, v):\n    if type(v) in cls.bytes_functions:  # it's a python native type\n        f = cls.bytes_functions[type(v)]\n    elif hasattr(v, \"dtype\"):  # it's a numpy/c type.\n        dtype = pytype(v)\n        f = cls.bytes_functions[dtype]\n    else:\n        f = cls.b_pickle\n    return f(v)\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.from_type_code","title":"<code>tablite.datatypes.DataTypes.from_type_code(value, code)</code>  <code>classmethod</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>@classmethod\ndef from_type_code(cls, value, code):\n    f = cls.type_code_functions[code]\n    return f(value)\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.pattern_to_datetime","title":"<code>tablite.datatypes.DataTypes.pattern_to_datetime(iso_string, ymd=None, T=None, compact=0, day_first=False)</code>  <code>staticmethod</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>@staticmethod\ndef pattern_to_datetime(iso_string, ymd=None, T=None, compact=0, day_first=False):\n    assert isinstance(iso_string, str)\n    if compact:\n        s = iso_string\n        if compact == 1:  # has T\n            slices = [\n                (0, 4, \"-\"),\n                (4, 6, \"-\"),\n                (6, 8, \"T\"),\n                (9, 11, \":\"),\n                (11, 13, \":\"),\n                (13, len(s), \"\"),\n            ]\n        elif compact == 2:  # has no T.\n            slices = [\n                (0, 4, \"-\"),\n                (4, 6, \"-\"),\n                (6, 8, \"T\"),\n                (8, 10, \":\"),\n                (10, 12, \":\"),\n                (12, len(s), \"\"),\n            ]\n        elif compact == 3:  # has T and :\n            slices = [\n                (0, 4, \"-\"),\n                (4, 6, \"-\"),\n                (6, 8, \"T\"),\n                (9, 11, \":\"),\n                (12, 14, \":\"),\n                (15, len(s), \"\"),\n            ]\n        else:\n            raise TypeError\n        iso_string = \"\".join([s[a:b] + c for a, b, c in slices if b &lt;= len(s)])\n        iso_string = iso_string.rstrip(\":\")\n\n    if day_first:\n        s = iso_string\n        iso_string = \"\".join((s[6:10], \"-\", s[3:5], \"-\", s[0:2], s[10:]))\n\n    if \",\" in iso_string:\n        iso_string = iso_string.replace(\",\", \".\")\n\n    dot = iso_string[::-1].find(\".\")\n    if 0 &lt; dot &lt; 10:\n        ix = len(iso_string) - dot\n        microsecond = int(float(f\"0{iso_string[ix - 1:]}\") * 10**6)\n        # fmt:off\n        iso_string = iso_string[: len(iso_string) - dot] + str(microsecond).rjust(6, \"0\")\n        # fmt:on\n    if ymd:\n        iso_string = iso_string.replace(ymd, \"-\", 2)\n    if T:\n        iso_string = iso_string.replace(T, \"T\")\n    return datetime.fromisoformat(iso_string)\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.round","title":"<code>tablite.datatypes.DataTypes.round(value, multiple, up=None)</code>  <code>classmethod</code>","text":"<p>a nicer way to round numbers.</p> PARAMETER  DESCRIPTION <code>value</code> <p>value to be rounded</p> <p> TYPE: <code>(float, integer, datetime)</code> </p> <code>multiple</code> <p>value to be used as the based of rounding. 1) multiple = 1 is the same as rounding to whole integers. 2) multiple = 0.001 is the same as rounding to 3 digits precision. 3) mulitple = 3.1415 is rounding to nearest multiplier of 3.1415 4) value = datetime(2022,8,18,11,14,53,440) 5) multiple = timedelta(hours=0.5) 6) xround(value,multiple) is datetime(2022,8,18,11,0)</p> <p> TYPE: <code>(float, integer, timedelta)</code> </p> <code>up</code> <p>None (default) or boolean rounds half, up or down. round(1.6, 1) rounds to 2. round(1.4, 1) rounds to 1. round(1.5, 1, up=True) rounds to 2. round(1.5, 1, up=False) rounds to 1.</p> <p> TYPE: <code>(None, bool)</code> DEFAULT: <code>None</code> </p> RETURNS DESCRIPTION <p>float,integer,datetime: rounded value in same type as input.</p> Source code in <code>tablite/datatypes.py</code> <pre><code>@classmethod\ndef round(cls, value, multiple, up=None):\n    \"\"\"a nicer way to round numbers.\n\n    Args:\n        value (float,integer,datetime): value to be rounded\n\n        multiple (float,integer,timedelta): value to be used as the based of rounding.\n            1) multiple = 1 is the same as rounding to whole integers.\n            2) multiple = 0.001 is the same as rounding to 3 digits precision.\n            3) mulitple = 3.1415 is rounding to nearest multiplier of 3.1415\n            4) value = datetime(2022,8,18,11,14,53,440)\n            5) multiple = timedelta(hours=0.5)\n            6) xround(value,multiple) is datetime(2022,8,18,11,0)\n\n        up (None, bool, optional):\n            None (default) or boolean rounds half, up or down.\n            round(1.6, 1) rounds to 2.\n            round(1.4, 1) rounds to 1.\n            round(1.5, 1, up=True) rounds to 2.\n            round(1.5, 1, up=False) rounds to 1.\n\n    Returns:\n        float,integer,datetime: rounded value in same type as input.\n    \"\"\"\n    epoch = 0\n    if isinstance(value, (datetime)) and isinstance(multiple, timedelta):\n        if value.tzinfo is None:\n            epoch = cls.epoch_no_tz\n        else:\n            epoch = cls.epoch\n\n    value2 = value - epoch\n    if value2 == 0:\n        return value2\n\n    low = (value2 // multiple) * multiple\n    high = low + multiple\n    if up is True:\n        return high + epoch\n    elif up is False:\n        return low + epoch\n    else:\n        if abs((high + epoch) - value) &lt; abs(value - (low + epoch)):\n            return high + epoch\n        else:\n            return low + epoch\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.to_json","title":"<code>tablite.datatypes.DataTypes.to_json(v)</code>  <code>staticmethod</code>","text":"<p>converts any python type to json.</p> PARAMETER  DESCRIPTION <code>v</code> <p>value to convert to json</p> <p> TYPE: <code>any</code> </p> RETURNS DESCRIPTION <p>json compatible value from v</p> Source code in <code>tablite/datatypes.py</code> <pre><code>@staticmethod\ndef to_json(v):\n    \"\"\"converts any python type to json.\n\n    Args:\n        v (any): value to convert to json\n\n    Returns:\n        json compatible value from v\n    \"\"\"\n    if hasattr(v, \"dtype\"):\n        v = numpy_to_python(v)\n    if v is None:\n        return v\n    elif v is False:\n        # using isinstance(v, bool): won't work as False also is int of zero.\n        return str(v)\n    elif v is True:\n        return str(v)\n    elif isinstance(v, int):\n        return v\n    elif isinstance(v, str):\n        return v\n    elif isinstance(v, float):\n        return v\n    elif isinstance(v, datetime):\n        return v.isoformat()\n    elif isinstance(v, time):\n        return v.isoformat()\n    elif isinstance(v, date):\n        return v.isoformat()\n    elif isinstance(v, timedelta):\n        return f\"P{v.days}DT{v.seconds + (v.microseconds / 1e6)}S\"\n    else:\n        raise TypeError(f\"The datatype {type(v)} is not supported.\")\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.from_json","title":"<code>tablite.datatypes.DataTypes.from_json(v, dtype)</code>  <code>staticmethod</code>","text":"<p>converts json to python datatype</p> PARAMETER  DESCRIPTION <code>v</code> <p>value</p> <p> TYPE: <code>any</code> </p> <code>dtype</code> <p>any python type</p> <p> TYPE: <code>python type</code> </p> RETURNS DESCRIPTION <p>python type of value v</p> Source code in <code>tablite/datatypes.py</code> <pre><code>@staticmethod\ndef from_json(v, dtype):\n    \"\"\"converts json to python datatype\n\n    Args:\n        v (any): value\n        dtype (python type): any python type\n\n    Returns:\n        python type of value v\n    \"\"\"\n    if v in DataTypes.nones:\n        if dtype is str and v == \"\":\n            return \"\"\n        else:\n            return None\n    if dtype is int:\n        return int(v)\n    elif dtype is str:\n        return str(v)\n    elif dtype is float:\n        return float(v)\n    elif dtype is bool:\n        if v == \"False\":\n            return False\n        elif v == \"True\":\n            return True\n        else:\n            raise ValueError(v)\n    elif dtype is date:\n        return date.fromisoformat(v)\n    elif dtype is datetime:\n        return datetime.fromisoformat(v)\n    elif dtype is time:\n        return time.fromisoformat(v)\n    elif dtype is timedelta:\n        L = v.split(\"DT\")\n        days = int(L[0].lstrip(\"P\"))\n        seconds = float(L[1].rstrip(\"S\"))\n        return timedelta(days, seconds)\n    else:\n        raise TypeError(f\"The datatype {str(dtype)} is not supported.\")\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.guess_types","title":"<code>tablite.datatypes.DataTypes.guess_types(*values)</code>  <code>staticmethod</code>","text":"<p>Attempts to guess the datatype for *values returns dict with matching datatypes and probabilities</p> RETURNS DESCRIPTION <code>dict</code> <p>{key: type, value: probability}</p> Source code in <code>tablite/datatypes.py</code> <pre><code>@staticmethod\ndef guess_types(*values):\n    \"\"\"Attempts to guess the datatype for *values\n    returns dict with matching datatypes and probabilities\n\n    Returns:\n        dict: {key: type, value: probability}\n    \"\"\"\n    d = defaultdict(int)\n    probability = Rank(DataTypes.types[:])\n\n    for value in values:\n        if hasattr(value, \"dtype\"):\n            value = numpy_to_python(value)\n\n        for dtype in probability:\n            try:\n                _ = DataTypes.infer(value, dtype)\n                d[dtype] += 1\n                probability.match(dtype)\n                break\n            except (ValueError, TypeError):\n                pass\n    if not d:\n        d[str] = len(values)\n    return {k: round(v / len(values), 3) for k, v in d.items()}\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.guess","title":"<code>tablite.datatypes.DataTypes.guess(*values)</code>  <code>staticmethod</code>","text":"<p>Makes a best guess the datatype for *values returns list of native python values</p> RETURNS DESCRIPTION <code>list</code> <p>list of native python values</p> Source code in <code>tablite/datatypes.py</code> <pre><code>@staticmethod\ndef guess(*values):\n    \"\"\"Makes a best guess the datatype for *values\n    returns list of native python values\n\n    Returns:\n        list: list of native python values\n    \"\"\"\n    probability = Rank(*DataTypes.types[:])\n    matches = [None for _ in values[0]]\n\n    for ix, value in enumerate(values[0]):\n        if hasattr(value, \"dtype\"):\n            value = numpy_to_python(value)\n        for dtype in probability:\n            try:\n                matches[ix] = DataTypes.infer(value, dtype)\n                probability.match(dtype)\n                break\n            except (ValueError, TypeError):\n                pass\n    return matches\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.DataTypes.infer","title":"<code>tablite.datatypes.DataTypes.infer(v, dtype)</code>  <code>classmethod</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>@classmethod\ndef infer(cls, v, dtype):\n    if isinstance(v, str) and dtype == str:\n        # we got a string, we're trying to infer it to string, we shouldn't check for None-ness\n        return v\n\n    if v in DataTypes.nones:\n        return None\n\n    if dtype not in matched_types:\n        raise TypeError(f\"The datatype {str(dtype)} is not supported.\")\n\n    return matched_types[dtype](v)\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.Rank","title":"<code>tablite.datatypes.Rank(*items)</code>","text":"<p>             Bases: <code>object</code></p> Source code in <code>tablite/datatypes.py</code> <pre><code>def __init__(self, *items):\n    self.items = {i: ix for i, ix in zip(items, range(len(items)))}\n    self.ranks = [0 for _ in items]\n    self.items_list = [i for i in items]\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.Rank-attributes","title":"Attributes","text":""},{"location":"reference/datatypes/#tablite.datatypes.Rank.items","title":"<code>tablite.datatypes.Rank.items = {i: ixfor (i, ix) in zip(items, range(len(items)))}</code>  <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.Rank.ranks","title":"<code>tablite.datatypes.Rank.ranks = [0 for _ in items]</code>  <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.Rank.items_list","title":"<code>tablite.datatypes.Rank.items_list = [i for i in items]</code>  <code>instance-attribute</code>","text":""},{"location":"reference/datatypes/#tablite.datatypes.Rank-functions","title":"Functions","text":""},{"location":"reference/datatypes/#tablite.datatypes.Rank.match","title":"<code>tablite.datatypes.Rank.match(k)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def match(self, k):  # k+=1\n    ix = self.items[k]\n    r = self.ranks\n    r[ix] += 1\n\n    if ix &gt; 0:\n        p = self.items_list\n        while (\n            r[ix] &gt; r[ix - 1] and ix &gt; 0\n        ):  # use a simple bubble sort to maintain rank\n            r[ix], r[ix - 1] = r[ix - 1], r[ix]\n            p[ix], p[ix - 1] = p[ix - 1], p[ix]\n            old = p[ix]\n            self.items[old] = ix\n            self.items[k] = ix - 1\n            ix -= 1\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.Rank.__iter__","title":"<code>tablite.datatypes.Rank.__iter__()</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def __iter__(self):\n    return iter(self.items_list)\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.MetaArray","title":"<code>tablite.datatypes.MetaArray</code>","text":"<p>             Bases: <code>ndarray</code></p> <p>Array with metadata.</p>"},{"location":"reference/datatypes/#tablite.datatypes.MetaArray-functions","title":"Functions","text":""},{"location":"reference/datatypes/#tablite.datatypes.MetaArray.__new__","title":"<code>tablite.datatypes.MetaArray.__new__(array, dtype=None, order=None, **kwargs)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def __new__(cls, array, dtype=None, order=None, **kwargs):\n    obj = np.asarray(array, dtype=dtype, order=order).view(cls)\n    obj.metadata = kwargs\n    return obj\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.MetaArray.__array_finalize__","title":"<code>tablite.datatypes.MetaArray.__array_finalize__(obj)</code>","text":"Source code in <code>tablite/datatypes.py</code> <pre><code>def __array_finalize__(self, obj):\n    if obj is None:\n        return\n    self.metadata = getattr(obj, \"metadata\", None)\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes-functions","title":"Functions","text":""},{"location":"reference/datatypes/#tablite.datatypes.numpy_to_python","title":"<code>tablite.datatypes.numpy_to_python(obj: Any) -&gt; Any</code>","text":"<p>Converts numpy types to python types.</p> <p>See https://numpy.org/doc/stable/reference/arrays.scalars.html</p> PARAMETER  DESCRIPTION <code>obj</code> <p>A numpy object</p> <p> TYPE: <code>Any</code> </p> RETURNS DESCRIPTION <code>Any</code> <p>python object: A python object</p> Source code in <code>tablite/datatypes.py</code> <pre><code>def numpy_to_python(obj: Any) -&gt; Any:\n    \"\"\"Converts numpy types to python types.\n\n    See https://numpy.org/doc/stable/reference/arrays.scalars.html\n\n    Args:\n        obj (Any): A numpy object\n\n    Returns:\n        python object: A python object\n    \"\"\"\n    if isinstance(obj, np.generic):\n        return obj.item()\n    return obj\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.pytype","title":"<code>tablite.datatypes.pytype(obj)</code>","text":"<p>Returns the python type of any object</p> PARAMETER  DESCRIPTION <code>obj</code> <p>any numpy or python object</p> <p> TYPE: <code>Any</code> </p> RETURNS DESCRIPTION <code>type</code> <p>type of obj</p> Source code in <code>tablite/datatypes.py</code> <pre><code>def pytype(obj):\n    \"\"\"Returns the python type of any object\n\n    Args:\n        obj (Any): any numpy or python object\n\n    Returns:\n        type: type of obj\n    \"\"\"\n    if isinstance(obj, np.generic):\n        return type(obj.item())\n    return type(obj)\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.pytype_from_iterable","title":"<code>tablite.datatypes.pytype_from_iterable(iterable: {tuple, list}) -&gt; {np.dtype, dict}</code>","text":"<p>helper to make correct np array from python types.</p> PARAMETER  DESCRIPTION <code>iterable</code> <p>values to be converted to numpy array.</p> <p> TYPE: <code>(tuple, list)</code> </p> RAISES DESCRIPTION <code>NotImplementedError</code> <p>if datatype is not supported.</p> RETURNS DESCRIPTION <code>{dtype, dict}</code> <p>np.dtype: python type of the iterable.</p> Source code in <code>tablite/datatypes.py</code> <pre><code>def pytype_from_iterable(iterable: {tuple, list}) -&gt; {np.dtype, dict}:\n    \"\"\"helper to make correct np array from python types.\n\n    Args:\n        iterable (tuple,list): values to be converted to numpy array.\n\n    Raises:\n        NotImplementedError: if datatype is not supported.\n\n    Returns:\n        np.dtype: python type of the iterable.\n    \"\"\"\n    py_types = {}\n    if isinstance(iterable, (tuple, list)):\n        type_counter = Counter((pytype(v) for v in iterable))\n\n        for k, v in type_counter.items():\n            py_types[k] = v\n\n        if len(py_types) == 0:\n            np_dtype, py_dtype = object, bool\n        elif len(py_types) == 1:\n            py_dtype = list(py_types.keys())[0]\n            if py_dtype == datetime:\n                np_dtype = np.datetime64\n            elif py_dtype == date:\n                np_dtype = np.datetime64\n            elif py_dtype == timedelta:\n                np_dtype = np.timedelta64\n            else:\n                np_dtype = None\n        else:\n            np_dtype = object\n    elif isinstance(iterable, np.ndarray):\n        if iterable.dtype == object:\n            np_dtype = object\n            py_types = dict(Counter((pytype(v) for v in iterable)))\n        else:\n            np_dtype = iterable.dtype\n            if len(iterable) &gt; 0:\n                py_types = {pytype(iterable[0]): len(iterable)}\n            else:\n                py_types = {pytype(np_dtype.type()): len(iterable)}\n    else:\n        raise NotImplementedError(f\"No handler for {type(iterable)}\")\n\n    return np_dtype, py_types\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.list_to_np_array","title":"<code>tablite.datatypes.list_to_np_array(iterable)</code>","text":"<p>helper to make correct np array from python types. Example of problem where numpy turns mixed types into strings.</p> <p>np.array([4, '5']) np.ndarray(['4', '5'])</p> RETURNS DESCRIPTION <p>np.array</p> <p>datatypes</p> Source code in <code>tablite/datatypes.py</code> <pre><code>def list_to_np_array(iterable):\n    \"\"\"helper to make correct np array from python types.\n    Example of problem where numpy turns mixed types into strings.\n    &gt;&gt;&gt; np.array([4, '5'])\n    np.ndarray(['4', '5'])\n\n    returns:\n        np.array\n        datatypes\n    \"\"\"\n    np_dtype, py_dtype = pytype_from_iterable(iterable)\n\n    value = MetaArray(iterable, dtype=np_dtype, py_dtype=py_dtype)\n    return value\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.np_type_unify","title":"<code>tablite.datatypes.np_type_unify(arrays)</code>","text":"<p>unifies numpy types.</p> PARAMETER  DESCRIPTION <code>arrays</code> <p>List of numpy arrays</p> <p> TYPE: <code>list</code> </p> RETURNS DESCRIPTION <p>np.ndarray: numpy array of a single type.</p> Source code in <code>tablite/datatypes.py</code> <pre><code>def np_type_unify(arrays):\n    \"\"\"unifies numpy types.\n\n    Args:\n        arrays (list): List of numpy arrays\n\n    Returns:\n        np.ndarray: numpy array of a single type.\n    \"\"\"\n    dtypes = {arr.dtype: len(arr) for arr in arrays}\n    if len(dtypes) == 1:\n        dtype, _ = dtypes.popitem()\n    else:\n        for ix, arr in enumerate(arrays):\n            arrays[ix] = np.array(arr, dtype=object)\n        dtype = object\n    return np.concatenate(arrays, dtype=dtype)\n</code></pre>"},{"location":"reference/datatypes/#tablite.datatypes.multitype_set","title":"<code>tablite.datatypes.multitype_set(arr)</code>","text":"<p>prevents loss of True, False when calling sets.</p> <p>python looses values when called returning a set. Example:</p> <p>{1, True, 0, False}</p> PARAMETER  DESCRIPTION <code>arr</code> <p>iterable of mixed types.</p> <p> TYPE: <code>Iterable</code> </p> RETURNS DESCRIPTION <p>np.array: with unique values.</p> Source code in <code>tablite/datatypes.py</code> <pre><code>def multitype_set(arr):\n    \"\"\"prevents loss of True, False when calling sets.\n\n    python looses values when called returning a set. Example:\n    &gt;&gt;&gt; {1, True, 0, False}\n    {0,1}\n\n    Args:\n        arr (Iterable): iterable of mixed types.\n\n    Returns:\n        np.array: with unique values.\n    \"\"\"\n    L = [(type(v), v) for v in arr]\n    L = list(set(L))\n    L = [v for _, v in L]\n    return np.array(L, dtype=object)\n</code></pre>"},{"location":"reference/diff/","title":"Diff","text":""},{"location":"reference/diff/#tablite.diff","title":"<code>tablite.diff</code>","text":""},{"location":"reference/diff/#tablite.diff-classes","title":"Classes","text":""},{"location":"reference/diff/#tablite.diff-functions","title":"Functions","text":""},{"location":"reference/diff/#tablite.diff.diff","title":"<code>tablite.diff.diff(T, other, columns=None)</code>","text":"<p>compares table self with table other</p> PARAMETER  DESCRIPTION <code>self</code> <p>Table</p> <p> TYPE: <code>Table</code> </p> <code>other</code> <p>Table</p> <p> TYPE: <code>Table</code> </p> <code>columns</code> <p>list of column names to include in comparison. Defaults to None.</p> <p> TYPE: <code>List</code> DEFAULT: <code>None</code> </p> RETURNS DESCRIPTION <code>Table</code> <p>diff of self and other with diff in columns 1st and 2nd.</p> Source code in <code>tablite/diff.py</code> <pre><code>def diff(T, other, columns=None):\n    \"\"\"compares table self with table other\n\n    Args:\n        self (Table): Table\n        other (Table): Table\n        columns (List, optional): list of column names to include in comparison. Defaults to None.\n\n    Returns:\n        Table: diff of self and other with diff in columns 1st and 2nd.\n    \"\"\"\n    sub_cls_check(T, BaseTable)\n    sub_cls_check(other, BaseTable)\n    if columns is None:\n        columns = [name for name in T.columns if name in other.columns]\n    elif isinstance(columns, list) and all(isinstance(i, str) for i in columns):\n        for name in columns:\n            if name not in T.columns:\n                raise ValueError(f\"column '{name}' not found\")\n            if name not in other.columns:\n                raise ValueError(f\"column '{name}' not found\")\n    else:\n        raise TypeError(\"Expected list of column names\")\n\n    t1 = T[columns]\n    if issubclass(type(t1), BaseTable):\n        t1 = [tuple(r) for r in T.rows]\n    else:\n        t1 = list(T)\n    t2 = other[columns]\n    if issubclass(type(t2), BaseTable):\n        t2 = [tuple(r) for r in other.rows]\n    else:\n        t2 = list(other)\n\n    sm = difflib.SequenceMatcher(None, t1, t2)\n    new = type(T)()\n    first = unique_name(\"1st\", columns)\n    second = unique_name(\"2nd\", columns)\n    new.add_columns(*columns + [first, second])\n\n    news = {n: [] for n in new.columns}  # Cache for Work in progress.\n\n    for opc, t1a, t1b, t2a, t2b in sm.get_opcodes():\n        if opc == \"insert\":\n            for name, col in zip(columns, zip(*t2[t2a:t2b])):\n                news[name].extend(col)\n            news[first] += [\"-\"] * (t2b - t2a)\n            news[second] += [\"+\"] * (t2b - t2a)\n\n        elif opc == \"delete\":\n            for name, col in zip(columns, zip(*t1[t1a:t1b])):\n                news[name].extend(col)\n            news[first] += [\"+\"] * (t1b - t1a)\n            news[second] += [\"-\"] * (t1b - t1a)\n\n        elif opc == \"equal\":\n            for name, col in zip(columns, zip(*t2[t2a:t2b])):\n                news[name].extend(col)\n            news[first] += [\"=\"] * (t2b - t2a)\n            news[second] += [\"=\"] * (t2b - t2a)\n\n        elif opc == \"replace\":\n            for name, col in zip(columns, zip(*t2[t2a:t2b])):\n                news[name].extend(col)\n            news[first] += [\"r\"] * (t2b - t2a)\n            news[second] += [\"r\"] * (t2b - t2a)\n\n        else:\n            pass\n\n        # Clear cache to free up memory.\n        if len(news[first]) &gt; Config.PAGE_SIZE == 0:\n            for name, L in news.items():\n                new[name].extend(np.array(L))\n                L.clear()\n\n    for name, L in news.items():\n        new[name].extend(np.array(L))\n        L.clear()\n    return new\n</code></pre>"},{"location":"reference/export_utils/","title":"Export utils","text":""},{"location":"reference/export_utils/#tablite.export_utils","title":"<code>tablite.export_utils</code>","text":""},{"location":"reference/export_utils/#tablite.export_utils-classes","title":"Classes","text":""},{"location":"reference/export_utils/#tablite.export_utils-functions","title":"Functions","text":""},{"location":"reference/export_utils/#tablite.export_utils.to_sql","title":"<code>tablite.export_utils.to_sql(table, name)</code>","text":"<p>generates ANSI-92 compliant SQL.</p> PARAMETER  DESCRIPTION <code>name</code> <p>name of SQL table.</p> <p> TYPE: <code>str</code> </p> Source code in <code>tablite/export_utils.py</code> <pre><code>def to_sql(table, name):\n    \"\"\"\n    generates ANSI-92 compliant SQL.\n\n    args:\n        name (str): name of SQL table.\n    \"\"\"\n    sub_cls_check(table, BaseTable)\n    type_check(name, str)\n\n    prefix = name\n    name = \"T1\"\n    create_table = \"\"\"CREATE TABLE {} ({})\"\"\"\n    columns = []\n    for name, col in table.columns.items():\n        dtype = col.types()\n        if len(dtype) == 1:\n            dtype, _ = dtype.popitem()\n            if dtype is int:\n                dtype = \"INTEGER\"\n            elif dtype is float:\n                dtype = \"REAL\"\n            else:\n                dtype = \"TEXT\"\n        else:\n            dtype = \"TEXT\"\n        definition = f\"{name} {dtype}\"\n        columns.append(definition)\n\n    create_table = create_table.format(prefix, \", \".join(columns))\n\n    # return create_table\n    row_inserts = []\n    for row in table.rows:\n        row_inserts.append(str(tuple([i if i is not None else \"NULL\" for i in row])))\n    row_inserts = f\"INSERT INTO {prefix} VALUES \" + \",\".join(row_inserts)\n    return \"begin; {}; {}; commit;\".format(create_table, row_inserts)\n</code></pre>"},{"location":"reference/export_utils/#tablite.export_utils.to_pandas","title":"<code>tablite.export_utils.to_pandas(table)</code>","text":"<p>returns pandas.DataFrame</p> Source code in <code>tablite/export_utils.py</code> <pre><code>def to_pandas(table):\n    \"\"\"\n    returns pandas.DataFrame\n    \"\"\"\n    sub_cls_check(table, BaseTable)\n    try:\n        return pd.DataFrame(table.to_dict())  # noqa\n    except ImportError:\n        import pandas as pd  # noqa\n    return pd.DataFrame(table.to_dict())  # noqa\n</code></pre>"},{"location":"reference/export_utils/#tablite.export_utils.to_hdf5","title":"<code>tablite.export_utils.to_hdf5(table, path)</code>","text":"<p>creates a copy of the table as hdf5</p> <p>Note that some loss of type information is to be expected in columns of mixed type:</p> <p>t.show(dtype=True) +===+===+=====+=====+====+=====+=====+===================+==========+========+===============+===+=========================+=====+===+ | # | A |  B  |  C  | D  |  E  |  F  |         G         |    H     |   I    |       J       | K |            L            |  M  | O | |row|int|mixed|float|str |mixed| bool|      datetime     |   date   |  time  |   timedelta   |str|           int           |float|int| +---+---+-----+-----+----+-----+-----+-------------------+----------+--------+---------------+---+-------------------------+-----+---+ | 0 | -1|None | -1.1|    |None |False|2023-06-09 09:12:06|2023-06-09|09:12:06| 1 day, 0:00:00|b  |-100000000000000000000000|  inf| 11| | 1 |  1|    1|  1.1|1000|1    | True|2023-06-09 09:12:06|2023-06-09|09:12:06|2 days, 0:06:40|\u55e8  | 100000000000000000000000| -inf|-11| +===+===+=====+=====+====+=====+=====+===================+==========+========+===============+===+=========================+=====+===+ t.to_hdf5(filename) t2 = Table.from_hdf5(filename) t2.show(dtype=True) +===+===+=====+=====+=====+=====+=====+===================+===================+========+===============+===+=========================+=====+===+ | # | A |  B  |  C  |  D  |  E  |  F  |         G         |         H         |   I    |       J       | K |            L            |  M  | O | |row|int|mixed|float|mixed|mixed| bool|      datetime     |      datetime     |  time  |      str      |str|           int           |float|int| +---+---+-----+-----+-----+-----+-----+-------------------+-------------------+--------+---------------+---+-------------------------+-----+---+ | 0 | -1|None | -1.1|None |None |False|2023-06-09 09:12:06|2023-06-09 00:00:00|09:12:06|1 day, 0:00:00 |b  |-100000000000000000000000|  inf| 11| | 1 |  1|    1|  1.1| 1000|    1| True|2023-06-09 09:12:06|2023-06-09 00:00:00|09:12:06|2 days, 0:06:40|\u55e8  | 100000000000000000000000| -inf|-11| +===+===+=====+=====+=====+=====+=====+===================+===================+========+===============+===+=========================+=====+===+</p> Source code in <code>tablite/export_utils.py</code> <pre><code>def to_hdf5(table, path):\n    # fmt: off\n    \"\"\"\n    creates a copy of the table as hdf5\n\n    Note that some loss of type information is to be expected in columns of mixed type:\n    &gt;&gt;&gt; t.show(dtype=True)\n    +===+===+=====+=====+====+=====+=====+===================+==========+========+===============+===+=========================+=====+===+\n    | # | A |  B  |  C  | D  |  E  |  F  |         G         |    H     |   I    |       J       | K |            L            |  M  | O |\n    |row|int|mixed|float|str |mixed| bool|      datetime     |   date   |  time  |   timedelta   |str|           int           |float|int|\n    +---+---+-----+-----+----+-----+-----+-------------------+----------+--------+---------------+---+-------------------------+-----+---+\n    | 0 | -1|None | -1.1|    |None |False|2023-06-09 09:12:06|2023-06-09|09:12:06| 1 day, 0:00:00|b  |-100000000000000000000000|  inf| 11|\n    | 1 |  1|    1|  1.1|1000|1    | True|2023-06-09 09:12:06|2023-06-09|09:12:06|2 days, 0:06:40|\u55e8  | 100000000000000000000000| -inf|-11|\n    +===+===+=====+=====+====+=====+=====+===================+==========+========+===============+===+=========================+=====+===+\n    &gt;&gt;&gt; t.to_hdf5(filename)\n    &gt;&gt;&gt; t2 = Table.from_hdf5(filename)\n    &gt;&gt;&gt; t2.show(dtype=True)\n    +===+===+=====+=====+=====+=====+=====+===================+===================+========+===============+===+=========================+=====+===+\n    | # | A |  B  |  C  |  D  |  E  |  F  |         G         |         H         |   I    |       J       | K |            L            |  M  | O |\n    |row|int|mixed|float|mixed|mixed| bool|      datetime     |      datetime     |  time  |      str      |str|           int           |float|int|\n    +---+---+-----+-----+-----+-----+-----+-------------------+-------------------+--------+---------------+---+-------------------------+-----+---+\n    | 0 | -1|None | -1.1|None |None |False|2023-06-09 09:12:06|2023-06-09 00:00:00|09:12:06|1 day, 0:00:00 |b  |-100000000000000000000000|  inf| 11|\n    | 1 |  1|    1|  1.1| 1000|    1| True|2023-06-09 09:12:06|2023-06-09 00:00:00|09:12:06|2 days, 0:06:40|\u55e8  | 100000000000000000000000| -inf|-11|\n    +===+===+=====+=====+=====+=====+=====+===================+===================+========+===============+===+=========================+=====+===+\n    \"\"\"\n    # fmt: in\n    import h5py\n\n    sub_cls_check(table, BaseTable)\n    type_check(path, Path)\n\n    total = f\"{len(table.columns) * len(table):,}\"  # noqa\n    print(f\"writing {total} records to {path}\", end=\"\")\n\n    with h5py.File(path, \"w\") as f:\n        n = 0\n        for name, col in table.items():\n            try:\n                f.create_dataset(name, data=col[:])  # stored in hdf5 as '/name'\n            except TypeError:\n                f.create_dataset(name, data=[str(i) for i in col[:]])  # stored in hdf5 as '/name'\n            n += 1\n    print(\"... done\")\n</code></pre>"},{"location":"reference/export_utils/#tablite.export_utils.excel_writer","title":"<code>tablite.export_utils.excel_writer(table, path)</code>","text":"<p>writer for excel files.</p> <p>This can create xlsx files beyond Excels. If you're using pyexcel to read the data, you'll see the data is there. If you're using Excel, Excel will stop loading after 1,048,576 rows.</p> <p>See pyexcel for more details: http://docs.pyexcel.org/</p> Source code in <code>tablite/export_utils.py</code> <pre><code>def excel_writer(table, path):\n    \"\"\"\n    writer for excel files.\n\n    This can create xlsx files beyond Excels.\n    If you're using pyexcel to read the data, you'll see the data is there.\n    If you're using Excel, Excel will stop loading after 1,048,576 rows.\n\n    See pyexcel for more details:\n    http://docs.pyexcel.org/\n    \"\"\"\n    import pyexcel\n\n    sub_cls_check(table, BaseTable)\n    type_check(path, Path)\n\n    def gen(table):  # local helper\n        yield table.columns\n        for row in table.rows:\n            yield row\n\n    data = list(gen(table))\n    if path.suffix in [\".xls\", \".ods\"]:\n        data = [\n            [str(v) if (isinstance(v, (int, float)) and abs(v) &gt; 2**32 - 1) else DataTypes.to_json(v) for v in row]\n            for row in data\n        ]\n\n    pyexcel.save_as(array=data, dest_file_name=str(path))\n</code></pre>"},{"location":"reference/export_utils/#tablite.export_utils.to_json","title":"<code>tablite.export_utils.to_json(table, *args, **kwargs)</code>","text":"Source code in <code>tablite/export_utils.py</code> <pre><code>def to_json(table, *args, **kwargs):\n    import json\n\n    sub_cls_check(table, BaseTable)\n    return json.dumps(table.as_json_serializable())\n</code></pre>"},{"location":"reference/export_utils/#tablite.export_utils.path_suffix_check","title":"<code>tablite.export_utils.path_suffix_check(path, kind)</code>","text":"Source code in <code>tablite/export_utils.py</code> <pre><code>def path_suffix_check(path, kind):\n    if not path.suffix == kind:\n        raise ValueError(f\"Suffix mismatch: Expected {kind}, got {path.suffix} in {path.name}\")\n    if not path.parent.exists():\n        raise FileNotFoundError(f\"directory {path.parent} not found.\")\n</code></pre>"},{"location":"reference/export_utils/#tablite.export_utils.text_writer","title":"<code>tablite.export_utils.text_writer(table, path, tqdm=_tqdm)</code>","text":"<p>exports table to csv, tsv or txt dependening on path suffix. follows the JSON norm. text escape is ON for all strings.</p>"},{"location":"reference/export_utils/#tablite.export_utils.text_writer--note","title":"Note:","text":"<p>If the delimiter is present in a string when the string is exported, text-escape is required, as the format otherwise is corrupted. When the file is being written, it is unknown whether any string in a column contrains the delimiter. As text escaping the few strings that may contain the delimiter would lead to an assymmetric format, the safer guess is to text escape all strings.</p> Source code in <code>tablite/export_utils.py</code> <pre><code>def text_writer(table, path, tqdm=_tqdm):\n    \"\"\"exports table to csv, tsv or txt dependening on path suffix.\n    follows the JSON norm. text escape is ON for all strings.\n\n    Note:\n    ----------------------\n    If the delimiter is present in a string when the string is exported,\n    text-escape is required, as the format otherwise is corrupted.\n    When the file is being written, it is unknown whether any string in\n    a column contrains the delimiter. As text escaping the few strings\n    that may contain the delimiter would lead to an assymmetric format,\n    the safer guess is to text escape all strings.\n    \"\"\"\n    sub_cls_check(table, BaseTable)\n    type_check(path, Path)\n\n    def txt(value):  # helper for text writer\n        if value is None:\n            return \"\"  # A column with 1,None,2 must be \"1,,2\".\n        elif isinstance(value, str):\n            # if not (value.startswith('\"') and value.endswith('\"')):\n            #     return f'\"{value}\"'  # this must be escape: \"the quick fox, jumped over the comma\"\n            # else:\n            return value  # this would for example be an empty string: \"\"\n        else:\n            return str(DataTypes.to_json(value))  # this handles datetimes, timedelta, etc.\n\n    delimiters = {\".csv\": \",\", \".tsv\": \"\\t\", \".txt\": \"|\"}\n    delimiter = delimiters.get(path.suffix)\n\n    with path.open(\"w\", encoding=\"utf-8\") as fo:\n        fo.write(delimiter.join(c for c in table.columns) + \"\\n\")\n        for row in tqdm(table.rows, total=len(table), disable=Config.TQDM_DISABLE):\n            fo.write(delimiter.join(txt(c) for c in row) + \"\\n\")\n</code></pre>"},{"location":"reference/export_utils/#tablite.export_utils.sql_writer","title":"<code>tablite.export_utils.sql_writer(table, path)</code>","text":"Source code in <code>tablite/export_utils.py</code> <pre><code>def sql_writer(table, path):\n    type_check(table, BaseTable)\n    type_check(path, Path)\n    with path.open(\"w\", encoding=\"utf-8\") as fo:\n        fo.write(to_sql(table))\n</code></pre>"},{"location":"reference/export_utils/#tablite.export_utils.json_writer","title":"<code>tablite.export_utils.json_writer(table, path)</code>","text":"Source code in <code>tablite/export_utils.py</code> <pre><code>def json_writer(table, path):\n    type_check(table, BaseTable)\n    type_check(path, Path)\n    with path.open(\"w\") as fo:\n        fo.write(to_json(table))\n</code></pre>"},{"location":"reference/export_utils/#tablite.export_utils.to_html","title":"<code>tablite.export_utils.to_html(table, path)</code>","text":"Source code in <code>tablite/export_utils.py</code> <pre><code>def to_html(table, path):\n    type_check(table, BaseTable)\n    type_check(path, Path)\n    with path.open(\"w\", encoding=\"utf-8\") as fo:\n        fo.write(table._repr_html_(slice(0, len(table))))\n</code></pre>"},{"location":"reference/file_reader_utils/","title":"File reader utils","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils","title":"<code>tablite.file_reader_utils</code>","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils-attributes","title":"Attributes","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.ENCODING_GUESS_BYTES","title":"<code>tablite.file_reader_utils.ENCODING_GUESS_BYTES = 10000</code>  <code>module-attribute</code>","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.header_readers","title":"<code>tablite.file_reader_utils.header_readers = {'fods': excel_reader_headers, 'json': excel_reader_headers, 'simple': excel_reader_headers, 'rst': excel_reader_headers, 'mediawiki': excel_reader_headers, 'xlsx': excel_reader_headers, 'xlsm': excel_reader_headers, 'csv': text_reader_headers, 'tsv': text_reader_headers, 'txt': text_reader_headers, 'ods': ods_reader_headers}</code>  <code>module-attribute</code>","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils-classes","title":"Classes","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.TextEscape","title":"<code>tablite.file_reader_utils.TextEscape(openings='({[', closures=']})', text_qualifier='\"', delimiter=',', strip_leading_and_tailing_whitespace=False)</code>","text":"<p>             Bases: <code>object</code></p> <p>enables parsing of CSV with respecting brackets and text marks.</p> <p>Example: text_escape = TextEscape()  # set up the instance. for line in somefile.readlines():     list_of_words = text_escape(line)  # use the instance.     ...</p> <p>As an example, the Danes and Germans use \" for inches and ' for feet, so we will see data that contains nail (75 x 4 mm, 3\" x 3/12\"), so for this case ( and ) are valid escapes, but \" and ' aren't.</p> Source code in <code>tablite/file_reader_utils.py</code> <pre><code>def __init__(\n    self,\n    openings=\"({[\",\n    closures=\"]})\",\n    text_qualifier='\"',\n    delimiter=\",\",\n    strip_leading_and_tailing_whitespace=False,\n):\n    \"\"\"\n    As an example, the Danes and Germans use \" for inches and ' for feet,\n    so we will see data that contains nail (75 x 4 mm, 3\" x 3/12\"), so\n    for this case ( and ) are valid escapes, but \" and ' aren't.\n\n    \"\"\"\n    if openings is None:\n        openings = [None]\n    elif isinstance(openings, str):\n        self.openings = {c for c in openings}\n    else:\n        raise TypeError(f\"expected str, got {type(openings)}\")\n\n    if closures is None:\n        closures = [None]\n    elif isinstance(closures, str):\n        self.closures = {c for c in closures}\n    else:\n        raise TypeError(f\"expected str, got {type(closures)}\")\n\n    if not isinstance(delimiter, str):\n        raise TypeError(f\"expected str, got {type(delimiter)}\")\n    self.delimiter = delimiter\n    self._delimiter_length = len(delimiter)\n    self.strip_leading_and_tailing_whitespace = strip_leading_and_tailing_whitespace\n\n    if text_qualifier is None:\n        pass\n    elif text_qualifier in openings + closures:\n        raise ValueError(\"It's a bad idea to have qoute character appears in openings or closures.\")\n    else:\n        self.qoute = text_qualifier\n\n    if not text_qualifier:\n        if not self.strip_leading_and_tailing_whitespace:\n            self.c = self._call_1\n        else:\n            self.c = self._call_2\n    else:\n        self.c = self._call_3\n</code></pre>"},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.TextEscape-attributes","title":"Attributes","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.TextEscape.openings","title":"<code>tablite.file_reader_utils.TextEscape.openings = {c for c in openings}</code>  <code>instance-attribute</code>","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.TextEscape.closures","title":"<code>tablite.file_reader_utils.TextEscape.closures = {c for c in closures}</code>  <code>instance-attribute</code>","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.TextEscape.delimiter","title":"<code>tablite.file_reader_utils.TextEscape.delimiter = delimiter</code>  <code>instance-attribute</code>","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.TextEscape.strip_leading_and_tailing_whitespace","title":"<code>tablite.file_reader_utils.TextEscape.strip_leading_and_tailing_whitespace = strip_leading_and_tailing_whitespace</code>  <code>instance-attribute</code>","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.TextEscape.qoute","title":"<code>tablite.file_reader_utils.TextEscape.qoute = text_qualifier</code>  <code>instance-attribute</code>","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.TextEscape.c","title":"<code>tablite.file_reader_utils.TextEscape.c = self._call_1</code>  <code>instance-attribute</code>","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.TextEscape-functions","title":"Functions","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.TextEscape.__call__","title":"<code>tablite.file_reader_utils.TextEscape.__call__(s)</code>","text":"Source code in <code>tablite/file_reader_utils.py</code> <pre><code>def __call__(self, s):\n    return self.c(s)\n</code></pre>"},{"location":"reference/file_reader_utils/#tablite.file_reader_utils-functions","title":"Functions","text":""},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.split_by_sequence","title":"<code>tablite.file_reader_utils.split_by_sequence(text, sequence)</code>","text":"<p>helper to split text according to a split sequence.</p> Source code in <code>tablite/file_reader_utils.py</code> <pre><code>def split_by_sequence(text, sequence):\n    \"\"\"helper to split text according to a split sequence.\"\"\"\n    chunks = tuple()\n    for element in sequence:\n        idx = text.find(element)\n        if idx &lt; 0:\n            raise ValueError(f\"'{element}' not in row\")\n        chunk, text = text[:idx], text[len(element) + idx :]\n        chunks += (chunk,)\n    chunks += (text,)  # the remaining text.\n    return chunks\n</code></pre>"},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.detect_seperator","title":"<code>tablite.file_reader_utils.detect_seperator(text)</code>","text":"<p>:param path: pathlib.Path objects :param encoding: file encoding. :return: 1 character.</p> Source code in <code>tablite/file_reader_utils.py</code> <pre><code>def detect_seperator(text):\n    \"\"\"\n    :param path: pathlib.Path objects\n    :param encoding: file encoding.\n    :return: 1 character.\n    \"\"\"\n    # After reviewing the logic in the CSV sniffer, I concluded that all it\n    # really does is to look for a non-text character. As the separator is\n    # determined by the first line, which almost always is a line of headers,\n    # the text characters will be utf-8,16 or ascii letters plus white space.\n    # This leaves the characters ,;:| and \\t as potential separators, with one\n    # exception: files that use whitespace as separator. My logic is therefore\n    # to (1) find the set of characters that intersect with ',;:|\\t' which in\n    # practice is a single character, unless (2) it is empty whereby it must\n    # be whitespace.\n    if len(text) == 0:\n        return None\n    seps = {\",\", \"\\t\", \";\", \":\", \"|\"}.intersection(text)\n    if not seps:\n        if \" \" in text:\n            return \" \"\n        if \"\\n\" in text:\n            return \"\\n\"\n        else:\n            raise ValueError(\"separator not detected\")\n    if len(seps) == 1:\n        return seps.pop()\n    else:\n        frq = [(text.count(i), i) for i in seps]\n        frq.sort(reverse=True)  # most frequent first.\n        return frq[0][-1]\n</code></pre>"},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.text_reader_headers","title":"<code>tablite.file_reader_utils.text_reader_headers(path, delimiter, header_row_index, text_qualifier, linecount)</code>","text":"Source code in <code>tablite/file_reader_utils.py</code> <pre><code>def text_reader_headers(path, delimiter, header_row_index, text_qualifier, linecount):\n    d = {}\n    delimiters = {\n        \".csv\": \",\",\n        \".tsv\": \"\\t\",\n        \".txt\": None,\n    }\n\n    try:\n        with path.open(\"rb\") as fi:\n            rawdata = fi.read(ENCODING_GUESS_BYTES)\n            encoding = chardet.detect(rawdata)[\"encoding\"]\n\n        if delimiter is None:\n            with path.open(\"r\", encoding=encoding, errors=\"ignore\") as fi:\n                lines = []\n                for n, line in enumerate(fi, -header_row_index):\n                    if n &lt; 0:\n                        continue\n                    line = line.rstrip(\"\\n\")\n                    lines.append(line)\n                    if n &gt;= linecount:\n                        break  # break on first\n                try:\n                    d[\"delimiter\"] = delimiter = detect_seperator(\"\\n\".join(lines))\n                except ValueError as e:\n                    if e.args == (\"separator not detected\", ):\n                        d[\"delimiter\"] = delimiter = None # this will handle the case of 1 column, 1 row\n                    else:\n                        raise e\n\n        if delimiter is None:\n            d[\"delimiter\"] = delimiter = delimiters[path.suffix]  # pickup the default one\n            d[path.name] = [lines]\n            d[\"is_empty\"] = True  # mark as empty to return an empty table instead of throwing\n        else:\n            kwargs = {}\n\n            if text_qualifier is not None:\n                kwargs[\"text_qualifier\"] = text_qualifier\n                kwargs[\"quoting\"] = \"QUOTE_MINIMAL\"\n            else:\n                kwargs[\"quoting\"] = \"QUOTE_NONE\"\n\n            d[path.name] = _get_headers(\n                str(path), py_to_nim_encoding(encoding), header_row_index=header_row_index,\n                delimiter=delimiter,\n                linecount=linecount,\n                **kwargs\n            )\n        return d\n    except Exception as e:\n        raise ValueError(f\"can't read {path.suffix}\")\n</code></pre>"},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.excel_reader_headers","title":"<code>tablite.file_reader_utils.excel_reader_headers(path, delimiter, header_row_index, text_qualifier, linecount)</code>","text":"Source code in <code>tablite/file_reader_utils.py</code> <pre><code>def excel_reader_headers(path, delimiter, header_row_index, text_qualifier, linecount):\n    d = {}\n    book = openpyxl.open(str(path), read_only=True)\n\n    try:\n        all_sheets = book.sheetnames\n\n        for sheet_name, sheet in ((name, book[name]) for name in all_sheets):\n            fixup_worksheet(sheet)\n            if sheet.max_row is None:\n                max_rows = 0\n            else:\n                max_rows = min(sheet.max_row, linecount + 1)\n            container = [None] * max_rows\n            padding_ends = 0\n            max_column = sheet.max_column\n\n            for i, row_data in enumerate(sheet.iter_rows(0, header_row_index + max_rows, values_only=True), start=-header_row_index):\n                if i &lt; 0:\n                    # NOTE: for some reason `iter_rows` specifying a start row starts reading cells as binary, instead skip the rows that are before our first read row\n                    continue\n\n                # NOTE: text readers do not cast types and give back strings, neither should xlsx reader, can't find documentation if it's possible to ignore this via `iter_rows` instead of casting back to string\n                container[i] = [DataTypes.to_json(v) for v in row_data]\n\n                for j, cell in enumerate(reversed(row_data)):\n                    if cell is None:\n                        continue\n\n                    padding_ends = max(padding_ends, max_column - j)\n\n                    break\n\n            d[sheet_name] = [None if c is None else c[0:padding_ends] for c in container]\n            d[\"delimiter\"] = None\n    finally:\n        book.close()\n\n    return d\n</code></pre>"},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.ods_reader_headers","title":"<code>tablite.file_reader_utils.ods_reader_headers(path, delimiter, header_row_index, text_qualifier, linecount)</code>","text":"Source code in <code>tablite/file_reader_utils.py</code> <pre><code>def ods_reader_headers(path, delimiter, header_row_index, text_qualifier, linecount):\n    d = {\n        \"delimiter\": None\n    }\n    sheets = pyexcel.get_book_dict(file_name=str(path))\n\n    for sheet_name, data in sheets.items():\n        lines = [[DataTypes.to_json(v) for v in row] for row in data[header_row_index:header_row_index+linecount]]\n\n        d[sheet_name] = lines\n\n    return d\n</code></pre>"},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.get_headers","title":"<code>tablite.file_reader_utils.get_headers(path, delimiter=None, header_row_index=0, text_qualifier=None, linecount=10)</code>","text":"<p>file format definition csv     comma separated values tsv     tab separated values csvz        a zip file that contains one or many csv files tsvz        a zip file that contains one or many tsv files xls     a spreadsheet file format created by MS-Excel 97-2003 xlsx        MS-Excel Extensions to the Office Open XML SpreadsheetML File Format. xlsm        an MS-Excel Macro-Enabled Workbook file ods     open document spreadsheet fods        flat open document spreadsheet json        java script object notation html        html table of the data structure simple      simple presentation rst     rStructured Text presentation of the data mediawiki   media wiki table</p> Source code in <code>tablite/file_reader_utils.py</code> <pre><code>def get_headers(path, delimiter=None, header_row_index=0, text_qualifier=None, linecount=10):\n    \"\"\"\n    file format\tdefinition\n    csv\t    comma separated values\n    tsv\t    tab separated values\n    csvz\ta zip file that contains one or many csv files\n    tsvz\ta zip file that contains one or many tsv files\n    xls\t    a spreadsheet file format created by MS-Excel 97-2003\n    xlsx\tMS-Excel Extensions to the Office Open XML SpreadsheetML File Format.\n    xlsm\tan MS-Excel Macro-Enabled Workbook file\n    ods\t    open document spreadsheet\n    fods\tflat open document spreadsheet\n    json\tjava script object notation\n    html\thtml table of the data structure\n    simple\tsimple presentation\n    rst\t    rStructured Text presentation of the data\n    mediawiki\tmedia wiki table\n    \"\"\"\n    if isinstance(path, str):\n        path = Path(path)\n    if not isinstance(path, Path):\n        raise TypeError(\"expected pathlib path.\")\n    if not path.exists():\n        raise FileNotFoundError(str(path))\n    if delimiter is not None:\n        if not isinstance(delimiter, str):\n            raise TypeError(f\"expected str or None, not {type(delimiter)}\")\n\n    kwargs = {\n        \"path\": path,\n        \"delimiter\": delimiter,\n        \"header_row_index\": header_row_index,\n        \"text_qualifier\": text_qualifier,\n        \"linecount\": linecount\n   }\n\n    reader = header_readers.get(path.suffix[1:], None)\n\n    if reader is None:\n        raise TypeError(f\"file format for headers not supported: {path.suffix}\")\n\n    result = reader(**kwargs)\n\n    return result\n</code></pre>"},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.get_encoding","title":"<code>tablite.file_reader_utils.get_encoding(path, nbytes=ENCODING_GUESS_BYTES)</code>","text":"Source code in <code>tablite/file_reader_utils.py</code> <pre><code>def get_encoding(path, nbytes=ENCODING_GUESS_BYTES):\n    nbytes = min(nbytes, path.stat().st_size)\n    with path.open(\"rb\") as fi:\n        rawdata = fi.read(nbytes)\n        encoding = chardet.detect(rawdata)[\"encoding\"]\n        if encoding == \"ascii\":  # utf-8 is backwards compatible with ascii\n            return \"utf-8\"  # --   so should the first 10k chars not be enough,\n        return encoding  # --      the utf-8 encoding will still get it right.\n</code></pre>"},{"location":"reference/file_reader_utils/#tablite.file_reader_utils.get_delimiter","title":"<code>tablite.file_reader_utils.get_delimiter(path, encoding)</code>","text":"Source code in <code>tablite/file_reader_utils.py</code> <pre><code>def get_delimiter(path, encoding):\n    with path.open(\"r\", encoding=encoding, errors=\"ignore\") as fi:\n        lines = []\n        for n, line in enumerate(fi):\n            line = line.rstrip(\"\\n\")\n            lines.append(line)\n            if n &gt; 10:\n                break  # break on first\n        delimiter = detect_seperator(\"\\n\".join(lines))\n        if delimiter is None:\n            raise ValueError(\"Delimiter could not be determined\")\n        return delimiter\n</code></pre>"},{"location":"reference/groupby_utils/","title":"Groupby utils","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils","title":"<code>tablite.groupby_utils</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils-classes","title":"Classes","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy","title":"<code>tablite.groupby_utils.GroupBy</code>","text":"<p>             Bases: <code>object</code></p>"},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy-attributes","title":"Attributes","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.max","title":"<code>tablite.groupby_utils.GroupBy.max = 'max'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.min","title":"<code>tablite.groupby_utils.GroupBy.min = 'min'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.sum","title":"<code>tablite.groupby_utils.GroupBy.sum = 'sum'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.product","title":"<code>tablite.groupby_utils.GroupBy.product = 'product'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.first","title":"<code>tablite.groupby_utils.GroupBy.first = 'first'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.last","title":"<code>tablite.groupby_utils.GroupBy.last = 'last'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.count","title":"<code>tablite.groupby_utils.GroupBy.count = 'count'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.count_unique","title":"<code>tablite.groupby_utils.GroupBy.count_unique = 'count_unique'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.avg","title":"<code>tablite.groupby_utils.GroupBy.avg = 'avg'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.stdev","title":"<code>tablite.groupby_utils.GroupBy.stdev = 'stdev'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.median","title":"<code>tablite.groupby_utils.GroupBy.median = 'median'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/groupby_utils/#tablite.groupby_utils.GroupBy.mode","title":"<code>tablite.groupby_utils.GroupBy.mode = 'mode'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/","title":"Import utils","text":""},{"location":"reference/import_utils/#tablite.import_utils","title":"<code>tablite.import_utils</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils-attributes","title":"Attributes","text":""},{"location":"reference/import_utils/#tablite.import_utils.file_readers","title":"<code>tablite.import_utils.file_readers = {'fods': excel_reader, 'json': excel_reader, 'html': from_html, 'hdf5': from_hdf5, 'simple': excel_reader, 'rst': excel_reader, 'mediawiki': excel_reader, 'xlsx': excel_reader, 'xls': excel_reader, 'xlsm': excel_reader, 'csv': text_reader, 'tsv': text_reader, 'txt': text_reader, 'ods': ods_reader}</code>  <code>module-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.valid_readers","title":"<code>tablite.import_utils.valid_readers = ','.join(list(file_readers.keys()))</code>  <code>module-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils-classes","title":"Classes","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig","title":"<code>tablite.import_utils.TRconfig(source, destination, start, end, guess_datatypes, delimiter, text_qualifier, text_escape_openings, text_escape_closures, strip_leading_and_tailing_whitespace, encoding, newline_offsets, fields)</code>","text":"<p>             Bases: <code>object</code></p> Source code in <code>tablite/import_utils.py</code> <pre><code>def __init__(\n    self,\n    source,\n    destination,\n    start,\n    end,\n    guess_datatypes,\n    delimiter,\n    text_qualifier,\n    text_escape_openings,\n    text_escape_closures,\n    strip_leading_and_tailing_whitespace,\n    encoding,\n    newline_offsets,\n    fields\n) -&gt; None:\n    self.source = source\n    self.destination = destination\n    self.start = start\n    self.end = end\n    self.guess_datatypes = guess_datatypes\n    self.delimiter = delimiter\n    self.text_qualifier = text_qualifier\n    self.text_escape_openings = text_escape_openings\n    self.text_escape_closures = text_escape_closures\n    self.strip_leading_and_tailing_whitespace = strip_leading_and_tailing_whitespace\n    self.encoding = encoding\n    self.newline_offsets = newline_offsets\n    self.fields = fields\n    type_check(start, int),\n    type_check(end, int),\n    type_check(delimiter, str),\n    type_check(text_qualifier, (str, type(None))),\n    type_check(text_escape_openings, str),\n    type_check(text_escape_closures, str),\n    type_check(encoding, str),\n    type_check(strip_leading_and_tailing_whitespace, bool),\n    type_check(newline_offsets, list)\n    type_check(fields, dict)\n</code></pre>"},{"location":"reference/import_utils/#tablite.import_utils.TRconfig-attributes","title":"Attributes","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.source","title":"<code>tablite.import_utils.TRconfig.source = source</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.destination","title":"<code>tablite.import_utils.TRconfig.destination = destination</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.start","title":"<code>tablite.import_utils.TRconfig.start = start</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.end","title":"<code>tablite.import_utils.TRconfig.end = end</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.guess_datatypes","title":"<code>tablite.import_utils.TRconfig.guess_datatypes = guess_datatypes</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.delimiter","title":"<code>tablite.import_utils.TRconfig.delimiter = delimiter</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.text_qualifier","title":"<code>tablite.import_utils.TRconfig.text_qualifier = text_qualifier</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.text_escape_openings","title":"<code>tablite.import_utils.TRconfig.text_escape_openings = text_escape_openings</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.text_escape_closures","title":"<code>tablite.import_utils.TRconfig.text_escape_closures = text_escape_closures</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.strip_leading_and_tailing_whitespace","title":"<code>tablite.import_utils.TRconfig.strip_leading_and_tailing_whitespace = strip_leading_and_tailing_whitespace</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.encoding","title":"<code>tablite.import_utils.TRconfig.encoding = encoding</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.newline_offsets","title":"<code>tablite.import_utils.TRconfig.newline_offsets = newline_offsets</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.fields","title":"<code>tablite.import_utils.TRconfig.fields = fields</code>  <code>instance-attribute</code>","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig-functions","title":"Functions","text":""},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.copy","title":"<code>tablite.import_utils.TRconfig.copy()</code>","text":"Source code in <code>tablite/import_utils.py</code> <pre><code>def copy(self):\n    return TRconfig(**self.dict())\n</code></pre>"},{"location":"reference/import_utils/#tablite.import_utils.TRconfig.dict","title":"<code>tablite.import_utils.TRconfig.dict()</code>","text":"Source code in <code>tablite/import_utils.py</code> <pre><code>def dict(self):\n    return {k: v for k, v in self.__dict__.items() if not (k.startswith(\"_\") or callable(v))}\n</code></pre>"},{"location":"reference/import_utils/#tablite.import_utils-functions","title":"Functions","text":""},{"location":"reference/import_utils/#tablite.import_utils.from_pandas","title":"<code>tablite.import_utils.from_pandas(T, df)</code>","text":"<p>Creates Table using pd.to_dict('list')</p> <p>similar to:</p> <p>import pandas as pd df = pd.DataFrame({'a':[1,2,3], 'b':[4,5,6]}) df     a  b     0  1  4     1  2  5     2  3  6 df.to_dict('list')</p> <p>t = Table.from_dict(df.to_dict('list)) t.show()     +===+===+===+     | # | a | b |     |row|int|int|     +---+---+---+     | 0 |  1|  4|     | 1 |  2|  5|     | 2 |  3|  6|     +===+===+===+</p> Source code in <code>tablite/import_utils.py</code> <pre><code>def from_pandas(T, df):\n    \"\"\"\n    Creates Table using pd.to_dict('list')\n\n    similar to:\n    &gt;&gt;&gt; import pandas as pd\n    &gt;&gt;&gt; df = pd.DataFrame({'a':[1,2,3], 'b':[4,5,6]})\n    &gt;&gt;&gt; df\n        a  b\n        0  1  4\n        1  2  5\n        2  3  6\n    &gt;&gt;&gt; df.to_dict('list')\n    {'a': [1, 2, 3], 'b': [4, 5, 6]}\n\n    &gt;&gt;&gt; t = Table.from_dict(df.to_dict('list))\n    &gt;&gt;&gt; t.show()\n        +===+===+===+\n        | # | a | b |\n        |row|int|int|\n        +---+---+---+\n        | 0 |  1|  4|\n        | 1 |  2|  5|\n        | 2 |  3|  6|\n        +===+===+===+\n    \"\"\"\n    if not issubclass(T, BaseTable):\n        raise TypeError(\"Expected subclass of Table\")\n\n    return T(columns=df.to_dict(\"list\"))  # noqa\n</code></pre>"},{"location":"reference/import_utils/#tablite.import_utils.from_hdf5","title":"<code>tablite.import_utils.from_hdf5(T, path, tqdm=_tqdm, pbar=None)</code>","text":"<p>imports an exported hdf5 table.</p> <p>Note that some loss of type information is to be expected in columns of mixed type:</p> <p>t.show(dtype=True) +===+===+=====+=====+====+=====+=====+===================+==========+========+===============+===+=========================+=====+===+ | # | A |  B  |  C  | D  |  E  |  F  |         G         |    H     |   I    |       J       | K |            L            |  M  | O | |row|int|mixed|float|str |mixed| bool|      datetime     |   date   |  time  |   timedelta   |str|           int           |float|int| +---+---+-----+-----+----+-----+-----+-------------------+----------+--------+---------------+---+-------------------------+-----+---+ | 0 | -1|None | -1.1|    |None |False|2023-06-09 09:12:06|2023-06-09|09:12:06| 1 day, 0:00:00|b  |-100000000000000000000000|  inf| 11| | 1 |  1|    1|  1.1|1000|1    | True|2023-06-09 09:12:06|2023-06-09|09:12:06|2 days, 0:06:40|\u55e8 | 100000000000000000000000| -inf|-11| +===+===+=====+=====+====+=====+=====+===================+==========+========+===============+===+=========================+=====+===+ t.to_hdf5(filename) t2 = Table.from_hdf5(filename) t2.show(dtype=True) +===+===+=====+=====+=====+=====+=====+===================+===================+========+===============+===+=========================+=====+===+ | # | A |  B  |  C  |  D  |  E  |  F  |         G         |         H         |   I    |       J       | K |            L            |  M  | O | |row|int|mixed|float|mixed|mixed| bool|      datetime     |      datetime     |  time  |      str      |str|           int           |float|int| +---+---+-----+-----+-----+-----+-----+-------------------+-------------------+--------+---------------+---+-------------------------+-----+---+ | 0 | -1|None | -1.1|None |None |False|2023-06-09 09:12:06|2023-06-09 00:00:00|09:12:06|1 day, 0:00:00 |b  |-100000000000000000000000|  inf| 11| | 1 |  1|    1|  1.1| 1000|    1| True|2023-06-09 09:12:06|2023-06-09 00:00:00|09:12:06|2 days, 0:06:40|\u55e8 | 100000000000000000000000| -inf|-11| +===+===+=====+=====+=====+=====+=====+===================+===================+========+===============+===+=========================+=====+===+</p> Source code in <code>tablite/import_utils.py</code> <pre><code>def from_hdf5(T, path, tqdm=_tqdm, pbar=None):\n    \"\"\"\n    imports an exported hdf5 table.\n\n    Note that some loss of type information is to be expected in columns of mixed type:\n    &gt;&gt;&gt; t.show(dtype=True)\n    +===+===+=====+=====+====+=====+=====+===================+==========+========+===============+===+=========================+=====+===+\n    | # | A |  B  |  C  | D  |  E  |  F  |         G         |    H     |   I    |       J       | K |            L            |  M  | O |\n    |row|int|mixed|float|str |mixed| bool|      datetime     |   date   |  time  |   timedelta   |str|           int           |float|int|\n    +---+---+-----+-----+----+-----+-----+-------------------+----------+--------+---------------+---+-------------------------+-----+---+\n    | 0 | -1|None | -1.1|    |None |False|2023-06-09 09:12:06|2023-06-09|09:12:06| 1 day, 0:00:00|b  |-100000000000000000000000|  inf| 11|\n    | 1 |  1|    1|  1.1|1000|1    | True|2023-06-09 09:12:06|2023-06-09|09:12:06|2 days, 0:06:40|\u55e8 | 100000000000000000000000| -inf|-11|\n    +===+===+=====+=====+====+=====+=====+===================+==========+========+===============+===+=========================+=====+===+\n    &gt;&gt;&gt; t.to_hdf5(filename)\n    &gt;&gt;&gt; t2 = Table.from_hdf5(filename)\n    &gt;&gt;&gt; t2.show(dtype=True)\n    +===+===+=====+=====+=====+=====+=====+===================+===================+========+===============+===+=========================+=====+===+\n    | # | A |  B  |  C  |  D  |  E  |  F  |         G         |         H         |   I    |       J       | K |            L            |  M  | O |\n    |row|int|mixed|float|mixed|mixed| bool|      datetime     |      datetime     |  time  |      str      |str|           int           |float|int|\n    +---+---+-----+-----+-----+-----+-----+-------------------+-------------------+--------+---------------+---+-------------------------+-----+---+\n    | 0 | -1|None | -1.1|None |None |False|2023-06-09 09:12:06|2023-06-09 00:00:00|09:12:06|1 day, 0:00:00 |b  |-100000000000000000000000|  inf| 11|\n    | 1 |  1|    1|  1.1| 1000|    1| True|2023-06-09 09:12:06|2023-06-09 00:00:00|09:12:06|2 days, 0:06:40|\u55e8 | 100000000000000000000000| -inf|-11|\n    +===+===+=====+=====+=====+=====+=====+===================+===================+========+===============+===+=========================+=====+===+\n    \"\"\"\n    if not issubclass(T, BaseTable):\n        raise TypeError(\"Expected subclass of Table\")\n    import h5py\n\n    type_check(path, Path)\n    t = T()\n    with h5py.File(path, \"r\") as h5:\n        for col_name in h5.keys():\n            dset = h5[col_name]\n            arr = np.array(dset[:])\n            if arr.dtype == object:\n                arr = np.array(DataTypes.guess([v.decode(\"utf-8\") for v in arr]))\n            t[col_name] = arr\n    return t\n</code></pre>"},{"location":"reference/import_utils/#tablite.import_utils.from_json","title":"<code>tablite.import_utils.from_json(T, jsn)</code>","text":"<p>Imports tables exported using .to_json</p> Source code in <code>tablite/import_utils.py</code> <pre><code>def from_json(T, jsn):\n    \"\"\"\n    Imports tables exported using .to_json\n    \"\"\"\n    if not issubclass(T, BaseTable):\n        raise TypeError(\"Expected subclass of Table\")\n    import json\n\n    type_check(jsn, str)\n    d = json.loads(jsn)\n    return T(columns=d[\"columns\"])\n</code></pre>"},{"location":"reference/import_utils/#tablite.import_utils.from_html","title":"<code>tablite.import_utils.from_html(T, path, tqdm=_tqdm, pbar=None)</code>","text":"Source code in <code>tablite/import_utils.py</code> <pre><code>def from_html(T, path, tqdm=_tqdm, pbar=None):\n    if not issubclass(T, BaseTable):\n        raise TypeError(\"Expected subclass of Table\")\n    type_check(path, Path)\n\n    if pbar is None:\n        total = path.stat().st_size\n        pbar = tqdm(total=total, desc=\"from_html\", disable=Config.TQDM_DISABLE)\n\n    row_start, row_end = \"&lt;tr&gt;\", \"&lt;/tr&gt;\"\n    value_start, value_end = \"&lt;th&gt;\", \"&lt;/th&gt;\"\n    chunk = \"\"\n    t = None  # will be T()\n    start, end = 0, 0\n    data = {}\n    with path.open(\"r\") as fi:\n        while True:\n            start = chunk.find(row_start, start)  # row tag start\n            end = chunk.find(row_end, end)  # row tag end\n            if start == -1 or end == -1:\n                new = fi.read(100_000)\n                pbar.update(len(new))\n                if new == \"\":\n                    break\n                chunk += new\n                continue\n            # get indices from chunk\n            row = chunk[start + len(row_start) : end]\n            fields = [v.rstrip(value_end) for v in row.split(value_start)]\n            if not data:\n                headers = fields[:]\n                data = {f: [] for f in headers}\n                continue\n            else:\n                for field, header in zip(fields, headers):\n                    data[header].append(field)\n\n            chunk = chunk[end + len(row_end) :]\n\n            if len(data[headers[0]]) == Config.PAGE_SIZE:\n                if t is None:\n                    t = T(columns=data)\n                else:\n                    for k, v in data.items():\n                        t[k].extend(DataTypes.guess(v))\n                data = {f: [] for f in headers}\n\n    for k, v in data.items():\n        t[k].extend(DataTypes.guess(v))\n    return t\n</code></pre>"},{"location":"reference/import_utils/#tablite.import_utils.excel_reader","title":"<code>tablite.import_utils.excel_reader(T, path, first_row_has_headers=True, header_row_index=0, sheet=None, columns=None, skip_empty='NONE', start=0, limit=sys.maxsize, tqdm=_tqdm, **kwargs)</code>","text":"<p>returns Table from excel</p> <p>**kwargs are excess arguments that are ignored.</p> Source code in <code>tablite/import_utils.py</code> <pre><code>def excel_reader(T, path, first_row_has_headers=True, header_row_index=0, sheet=None, columns=None, skip_empty=\"NONE\", start=0, limit=sys.maxsize, tqdm=_tqdm, **kwargs):\n    \"\"\"\n    returns Table from excel\n\n    **kwargs are excess arguments that are ignored.\n    \"\"\"\n    if not issubclass(T, BaseTable):\n        raise TypeError(\"Expected subclass of Table\")\n\n    book = openpyxl.load_workbook(path, read_only=True, data_only=True)\n\n    if sheet is None:  # help the user.\n        \"\"\"\n            If no sheet specified, assume first sheet.\n\n            Reasoning:\n                Pandas ODS reader does that, so this preserves parity and it might be expected by users.\n                If we don't know the sheet name but only have single sheet,\n                    we would need to take extra steps to find out the name of the sheet.\n                We already make assumptions in case of column selection,\n                    when columns are None, we import all of them.\n        \"\"\"\n        sheet = book.sheetnames[0]\n    elif sheet not in book.sheetnames:\n        raise ValueError(f\"sheet not found: {sheet}\")\n\n    if not (isinstance(start, int) and start &gt;= 0):\n        raise ValueError(\"expected start as an integer &gt;=0\")\n    if not (isinstance(limit, int) and limit &gt; 0):\n        raise ValueError(\"expected limit as integer &gt; 0\")\n\n    worksheet = book[sheet]\n    fixup_worksheet(worksheet)\n\n    try:\n        it_header = worksheet.iter_rows(min_row=header_row_index + 1)\n        while True:\n            # get the first row to know our headers or the number of columns\n            row = [c.value for c in next(it_header)]\n            break\n        fields = [str(c) if c is not None else \"\" for c in row] # excel is offset by 1\n    except StopIteration:\n        # excel was empty, return empty table\n        return T()\n\n    if not first_row_has_headers:\n        # since the first row did not contain headers, we use the column count to populate header names\n        fields = [str(i) for i in range(len(fields))]\n\n    if columns is None:\n        # no columns were specified by user to import, that means we import all of the them\n        columns = []\n\n        for f in fields:\n            # fixup the duplicate column names\n            columns.append(unique_name(f, columns))\n\n        field_dict = {k: i for i, k in enumerate(columns)}\n    else:\n        field_dict = {}\n\n        for k, i in ((k, fields.index(k)) for k in columns):\n            # fixup the duplicate column names\n            field_dict[unique_name(k, field_dict.keys())] = i\n\n    # calculate our data rows iterator offset\n    it_offset = start + (1 if first_row_has_headers else 0) + header_row_index + 1\n\n    # attempt to fetch number of rows in the sheet\n    total_rows = worksheet.max_row\n    real_tqdm = True\n\n    if total_rows is None:\n        # i don't know what causes it but max_row can be None in some cases, so we don't know how large the dataset is\n        total_rows = it_offset + limit\n        real_tqdm = False\n\n    # create the actual data rows iterator\n    it_rows = worksheet.iter_rows(min_row=it_offset, max_row=min(it_offset+limit, total_rows))\n    it_used_indices = list(field_dict.values())\n\n    # filter columns that we're not going to use\n    it_rows_filtered = ([row[idx].value for idx in it_used_indices] for row in it_rows)\n\n    # create page directory\n    workdir = Path(Config.workdir) / Config.pid\n    pagesdir = workdir/\"pages\"\n    pagesdir.mkdir(exist_ok=True, parents=True)\n\n    field_names = list(field_dict.keys())\n    column_count = len(field_names)\n\n    page_fhs = None\n\n    # prepopulate the table with columns\n    table = T()\n    for name in field_names:\n        table[name] = Column(table.path)\n\n    pbar_fname = path.name\n    if len(pbar_fname) &gt; 20:\n        pbar_fname = pbar_fname[0:10] + \"...\" + pbar_fname[-7:]\n\n    if real_tqdm:\n        # we can create a true tqdm progress bar, make one\n        tqdm_iter = tqdm(it_rows_filtered, total=total_rows, desc=f\"importing excel: {pbar_fname}\")\n    else:\n        \"\"\"\n            openpyxls was unable to precalculate the size of the excel for whatever reason\n            forcing recalc would require parsing entire file\n            drop the progress bar in that case, just show iterations\n\n            as an alternative we can use \u03a3=1/x but it just doesn't look good, show iterations per second instead\n        \"\"\"\n        tqdm_iter = tqdm(it_rows_filtered, desc=f\"importing excel: {pbar_fname}\")\n\n    tqdm_iter = iter(tqdm_iter)\n\n    idx = 0\n\n    while True:\n        try:\n            row = next(tqdm_iter)\n        except StopIteration:\n            break # because in some cases we can't know the size of excel to set the upper iterator limit we loop until stop iteration is encountered\n\n        if skip_empty == \"ALL\" and all(v is None for v in row):\n            continue\n        elif skip_empty == \"ANY\" and any(v is None for v in row):\n            continue\n\n        if idx % Config.PAGE_SIZE == 0:\n            if page_fhs is not None:\n                # we reached the max page file size, fix the pages\n                [_fix_xls_page(table, c, fh) for c, fh in zip(field_names, page_fhs)]\n\n            page_fhs = [None] * column_count\n\n            for cidx in range(column_count):\n                # allocate new pages\n                pg_path = pagesdir / f\"{next(Page.ids)}.npy\"\n                page_fhs[cidx] = open(pg_path, \"wb\")\n\n        for fh, value in zip(page_fhs, row):\n            \"\"\"\n                since excel types are already cast into appropriate type we're going to do two passes per page\n\n                we create our temporary custom format:\n                packed type|packed byte count|packed bytes|...\n\n                available types:\n                    * q - int64\n                    * d - float64\n                    * s - string\n                    * b - boolean\n                    * n - none\n                    * p - pickled (date, time, datetime)\n            \"\"\"\n            dtype = type(value)\n\n            if dtype == int:\n                ptype, bytes_ = b'q', struct.pack('q', value) # pack int as int64\n            elif dtype == float:\n                ptype, bytes_ = b'd', struct.pack('d', value) # pack float as float64\n            elif dtype == str:\n                ptype, bytes_ = b's', value.encode(\"utf-8\")   # pack string\n            elif dtype == bool:\n                ptype, bytes_ = b'b', b'1' if value else b'0' # pack boolean\n            elif value is None:\n                ptype, bytes_ = b'n', b''                     # pack none\n            elif dtype in [date, time, datetime]:\n                ptype, bytes_ = b'p', pkl.dumps(value)        # pack object types via pickle\n            else:\n                raise NotImplementedError()\n\n            byte_count = struct.pack('I', len(bytes_))        # pack our payload size, i doubt payload size can be over uint32\n\n            # dump object to file\n            fh.write(ptype)\n            fh.write(byte_count)\n            fh.write(bytes_)\n\n        idx = idx + 1\n\n    if page_fhs is not None:\n        # we reached end of the loop, fix the pages\n        [_fix_xls_page(table, c, fh) for c, fh in zip(field_names, page_fhs)]\n\n    return table\n</code></pre>"},{"location":"reference/import_utils/#tablite.import_utils.ods_reader","title":"<code>tablite.import_utils.ods_reader(T, path, first_row_has_headers=True, header_row_index=0, sheet=None, columns=None, skip_empty='NONE', start=0, limit=sys.maxsize, **kwargs)</code>","text":"<p>returns Table from .ODS</p> Source code in <code>tablite/import_utils.py</code> <pre><code>def ods_reader(T, path, first_row_has_headers=True, header_row_index=0, sheet=None, columns=None, skip_empty=\"NONE\", start=0, limit=sys.maxsize, **kwargs):\n    \"\"\"\n    returns Table from .ODS\n    \"\"\"\n    if not issubclass(T, BaseTable):\n        raise TypeError(\"Expected subclass of Table\")\n\n    if sheet is None:\n        data = read_excel(str(path), header=None) # selects first sheet\n    else:\n        data = read_excel(str(path), sheet_name=sheet, header=None)\n\n    data[isna(data)] = None  # convert any empty cells to None\n    data = data.to_numpy().tolist() # convert pandas to list\n\n    if skip_empty == \"ALL\" or skip_empty == \"ANY\":\n        \"\"\" filter out all rows based on predicate that come after header row \"\"\"\n        fn_filter = any if skip_empty == \"ALL\" else all # this is intentional\n        data = [\n            row\n            for ridx, row in enumerate(data)\n            if ridx &lt; header_row_index + (1 if first_row_has_headers else 0) or fn_filter(not (v is None or isinstance(v, str) and len(v) == 0) for v in row)\n        ]\n\n    data = np.array(data, dtype=np.object_) # cast back to numpy array for slicing but don't try to convert datatypes\n\n    if not (isinstance(start, int) and start &gt;= 0):\n        raise ValueError(\"expected start as an integer &gt;=0\")\n    if not (isinstance(limit, int) and limit &gt; 0):\n        raise ValueError(\"expected limit as integer &gt; 0\")\n\n    t = T()\n\n    used_columns_names = set()\n    for ix, value in enumerate(data[header_row_index]):\n        if first_row_has_headers:\n            header, start_row_pos = \"\" if value is None else str(value), (1 + header_row_index)\n        else:\n            header, start_row_pos = f\"_{ix + 1}\", (0 + header_row_index)\n\n        if columns is not None:\n            if header not in columns:\n                continue\n\n        unique_column_name = unique_name(str(header), used_columns_names)\n        used_columns_names.add(unique_column_name)\n\n        column_values = data[start_row_pos : start_row_pos + limit, ix]\n\n        t[unique_column_name] = column_values\n    return t\n</code></pre>"},{"location":"reference/import_utils/#tablite.import_utils.text_reader_task","title":"<code>tablite.import_utils.text_reader_task(source, destination, start, end, guess_datatypes, delimiter, text_qualifier, text_escape_openings, text_escape_closures, strip_leading_and_tailing_whitespace, encoding, newline_offsets, fields)</code>","text":"<p>PARALLEL TASK FUNCTION reads columnsname + path[start:limit] into hdf5.</p> <p>source: csv or txt file destination: filename for page. start: int: start of page. end: int: end of page. guess_datatypes: bool: if True datatypes will be inferred by datatypes.Datatypes.guess delimiter: ',' ';' or '|' text_qualifier: str: commonly \" text_escape_openings: str: default: \"({[ text_escape_closures: str: default: ]})\" strip_leading_and_tailing_whitespace: bool encoding: chardet encoding ('utf-8, 'ascii', ..., 'ISO-22022-CN')</p> Source code in <code>tablite/import_utils.py</code> <pre><code>def text_reader_task(\n    source,\n    destination,\n    start,\n    end,\n    guess_datatypes,\n    delimiter,\n    text_qualifier,\n    text_escape_openings,\n    text_escape_closures,\n    strip_leading_and_tailing_whitespace,\n    encoding,\n    newline_offsets,\n    fields\n):\n    \"\"\"PARALLEL TASK FUNCTION\n    reads columnsname + path[start:limit] into hdf5.\n\n    source: csv or txt file\n    destination: filename for page.\n    start: int: start of page.\n    end: int: end of page.\n    guess_datatypes: bool: if True datatypes will be inferred by datatypes.Datatypes.guess\n    delimiter: ',' ';' or '|'\n    text_qualifier: str: commonly \\\"\n    text_escape_openings: str: default: \"({[\n    text_escape_closures: str: default: ]})\"\n    strip_leading_and_tailing_whitespace: bool\n    encoding: chardet encoding ('utf-8, 'ascii', ..., 'ISO-22022-CN')\n    \"\"\"\n    if isinstance(source, str):\n        source = Path(source)\n    type_check(source, Path)\n    if not source.exists():\n        raise FileNotFoundError(f\"File not found: {source}\")\n    type_check(destination, list)\n\n    # declare CSV dialect.\n    delim = delimiter\n\n    class Dialect(csv.Dialect):\n        delimiter = delim\n        quotechar = '\"' if text_qualifier is None else text_qualifier\n        escapechar = '\\\\'\n        doublequote = True\n        quoting = csv.QUOTE_MINIMAL\n        skipinitialspace = False if strip_leading_and_tailing_whitespace is None else strip_leading_and_tailing_whitespace\n        lineterminator = \"\\n\"\n\n    with source.open(\"r\", encoding=encoding, errors=\"ignore\") as fi:  # --READ\n        fi.seek(newline_offsets[start])\n        reader = csv.reader(fi, dialect=Dialect)\n\n        # if there's an issue with file handlers on windows, we can make a special case for windows where the file is opened on demand and appended instead of opening all handlers at once\n        page_file_handlers = [open(f, mode=\"wb\") for f in destination]\n\n        # identify longest str\n        longest_str = [1 for _ in range(len(destination))]\n        for row in (next(reader) for _ in range(end - start)):\n            for idx, c in ((fields[idx], c) for idx, c in filter(lambda t: t[0] in fields, enumerate(row))):\n                longest_str[idx] = max(longest_str[idx], len(c))\n\n        column_formats = [f\"&lt;U{i}\" for i in longest_str]\n        for idx, cf in enumerate(column_formats):\n            _create_numpy_header(cf, (end - start, ), page_file_handlers[idx])\n\n        # write page arrays to files\n        fi.seek(newline_offsets[start])\n        for row in (next(reader) for _ in range(end - start)):\n            for idx, c in ((fields[idx], c) for idx, c in filter(lambda t: t[0] in fields, enumerate(row))):\n                cbytes = np.asarray(c, dtype=column_formats[idx]).tobytes()\n                page_file_handlers[idx].write(cbytes)\n\n        [phf.close() for phf in page_file_handlers]\n</code></pre>"},{"location":"reference/import_utils/#tablite.import_utils.text_reader","title":"<code>tablite.import_utils.text_reader(T, path, columns, first_row_has_headers, header_row_index, encoding, start, limit, newline, guess_datatypes, text_qualifier, strip_leading_and_tailing_whitespace, skip_empty, delimiter, text_escape_openings, text_escape_closures, tqdm=_tqdm, **kwargs)</code>","text":"Source code in <code>tablite/import_utils.py</code> <pre><code>def text_reader(\n    T,\n    path,\n    columns,\n    first_row_has_headers,\n    header_row_index,\n    encoding,\n    start,\n    limit,\n    newline,\n    guess_datatypes,\n    text_qualifier,\n    strip_leading_and_tailing_whitespace,\n    skip_empty,\n    delimiter,\n    text_escape_openings,\n    text_escape_closures,\n    tqdm=_tqdm,\n    **kwargs,\n):\n    if encoding is None:\n        encoding = get_encoding(path, nbytes=ENCODING_GUESS_BYTES)\n\n    enc = py_to_nim_encoding(encoding)\n    pid = Config.workdir / Config.pid\n    kwargs = {}\n\n    if first_row_has_headers is not None:\n        kwargs[\"first_row_has_headers\"] = first_row_has_headers\n    if header_row_index is not None:\n        kwargs[\"header_row_index\"] = header_row_index\n    if columns is not None:\n        kwargs[\"columns\"] = columns\n    if start is not None:\n        kwargs[\"start\"] = start\n    if limit is not None and limit != sys.maxsize:\n        kwargs[\"limit\"] = limit\n    if guess_datatypes is not None:\n        kwargs[\"guess_datatypes\"] = guess_datatypes\n    if newline is not None:\n        kwargs[\"newline\"] = newline\n    if delimiter is not None:\n        kwargs[\"delimiter\"] = delimiter\n    if text_qualifier is not None:\n        kwargs[\"text_qualifier\"] = text_qualifier\n        kwargs[\"quoting\"] = \"QUOTE_MINIMAL\"\n    else:\n        kwargs[\"quoting\"] = \"QUOTE_NONE\"\n    if strip_leading_and_tailing_whitespace is not None:\n        kwargs[\"strip_leading_and_tailing_whitespace\"] = strip_leading_and_tailing_whitespace\n\n    if skip_empty is None:\n        kwargs[\"skip_empty\"] = \"NONE\"\n    else:\n        kwargs[\"skip_empty\"] = skip_empty\n\n    return nimlite.text_reader(\n        T, pid, path, enc,\n        **kwargs,\n        tqdm=tqdm\n    )\n</code></pre>"},{"location":"reference/import_utils/#tablite.import_utils-modules","title":"Modules","text":""},{"location":"reference/imputation/","title":"Imputation","text":""},{"location":"reference/imputation/#tablite.imputation","title":"<code>tablite.imputation</code>","text":""},{"location":"reference/imputation/#tablite.imputation-classes","title":"Classes","text":""},{"location":"reference/imputation/#tablite.imputation-functions","title":"Functions","text":""},{"location":"reference/imputation/#tablite.imputation.imputation","title":"<code>tablite.imputation.imputation(T, targets, missing=None, method='carry forward', sources=None, tqdm=_tqdm, pbar=None)</code>","text":"<p>In statistics, imputation is the process of replacing missing data with substituted values.</p> <p>See more: https://en.wikipedia.org/wiki/Imputation_(statistics)</p> PARAMETER  DESCRIPTION <code>table</code> <p>source table.</p> <p> TYPE: <code>Table</code> </p> <code>targets</code> <p>column names to find and replace missing values</p> <p> TYPE: <code>str or list of strings</code> </p> <code>missing</code> <p>values to be replaced.</p> <p> TYPE: <code>None or iterable</code> DEFAULT: <code>None</code> </p> <code>method</code> <p>method to be used for replacement. Options:</p> <p>'carry forward':     takes the previous value, and carries forward into fields     where values are missing.     +: quick. Realistic on time series.     -: Can produce strange outliers.</p> <p>'mean':     calculates the column mean (exclude <code>missing</code>) and copies     the mean in as replacement.     +: quick     -: doesn't work on text. Causes data set to drift towards the mean.</p> <p>'mode':     calculates the column mode (exclude <code>missing</code>) and copies     the mean in as replacement.     +: quick     -: most frequent value becomes over-represented in the sample</p> <p>'nearest neighbour':     calculates normalised distance between items in source columns     selects nearest neighbour and copies value as replacement.     +: works for any datatype.     -: computationally intensive (e.g. slow)</p> <p> TYPE: <code>str</code> DEFAULT: <code>'carry forward'</code> </p> <code>sources</code> <p>NEAREST NEIGHBOUR ONLY column names to be used during imputation. if None or empty, all columns will be used.</p> <p> TYPE: <code>list of strings</code> DEFAULT: <code>None</code> </p> RETURNS DESCRIPTION <code>table</code> <p>table with replaced values.</p> Source code in <code>tablite/imputation.py</code> <pre><code>def imputation(T, targets, missing=None, method=\"carry forward\", sources=None, tqdm=_tqdm, pbar=None):\n    \"\"\"\n    In statistics, imputation is the process of replacing missing data with substituted values.\n\n    See more: https://en.wikipedia.org/wiki/Imputation_(statistics)\n\n    Args:\n        table (Table): source table.\n\n        targets (str or list of strings): column names to find and\n            replace missing values\n\n        missing (None or iterable): values to be replaced.\n\n        method (str): method to be used for replacement. Options:\n\n            'carry forward':\n                takes the previous value, and carries forward into fields\n                where values are missing.\n                +: quick. Realistic on time series.\n                -: Can produce strange outliers.\n\n            'mean':\n                calculates the column mean (exclude `missing`) and copies\n                the mean in as replacement.\n                +: quick\n                -: doesn't work on text. Causes data set to drift towards the mean.\n\n            'mode':\n                calculates the column mode (exclude `missing`) and copies\n                the mean in as replacement.\n                +: quick\n                -: most frequent value becomes over-represented in the sample\n\n            'nearest neighbour':\n                calculates normalised distance between items in source columns\n                selects nearest neighbour and copies value as replacement.\n                +: works for any datatype.\n                -: computationally intensive (e.g. slow)\n\n        sources (list of strings): NEAREST NEIGHBOUR ONLY\n            column names to be used during imputation.\n            if None or empty, all columns will be used.\n\n    Returns:\n        table: table with replaced values.\n    \"\"\"\n    sub_cls_check(T, BaseTable)\n\n    if isinstance(targets, str) and targets not in T.columns:\n        targets = [targets]\n    if isinstance(targets, list):\n        for name in targets:\n            if not isinstance(name, str):\n                raise TypeError(f\"expected str, not {type(name)}\")\n            if name not in T.columns:\n                raise ValueError(f\"target item {name} not a column name in T.columns:\\n{T.columns}\")\n    else:\n        raise TypeError(\"Expected source as list of column names\")\n\n    if missing is None:\n        missing = {None}\n    else:\n        missing = set(missing)\n\n    if method == \"nearest neighbour\":\n        if sources in (None, []):\n            sources = list(T.columns)\n        if isinstance(sources, str):\n            sources = [sources]\n        if isinstance(sources, list):\n            for name in sources:\n                if not isinstance(name, str):\n                    raise TypeError(f\"expected str, not {type(name)}\")\n                if name not in T.columns:\n                    raise ValueError(f\"source item {name} not a column name in T.columns:\\n{T.columns}\")\n        else:\n            raise TypeError(\"Expected source as list of column names\")\n\n    methods = [\"nearest neighbour\", \"mean\", \"mode\", \"carry forward\"]\n\n    if method == \"carry forward\":\n        return carry_forward(T, targets, missing, tqdm=tqdm, pbar=pbar)\n    elif method in {\"mean\", \"mode\"}:\n        return stats_method(T, targets, missing, method, tqdm=tqdm, pbar=pbar)\n    elif method == \"nearest neighbour\":\n        return nearest_neighbour(T, sources, missing, targets, tqdm=tqdm)\n    else:\n        raise ValueError(f\"method {method} not recognised amonst known methods: {list(methods)})\")\n</code></pre>"},{"location":"reference/imputation/#tablite.imputation.carry_forward","title":"<code>tablite.imputation.carry_forward(T, targets, missing, tqdm=_tqdm, pbar=None)</code>","text":"Source code in <code>tablite/imputation.py</code> <pre><code>def carry_forward(T, targets, missing, tqdm=_tqdm, pbar=None):\n    assert isinstance(missing, set)\n\n    if pbar is None:\n        total = len(targets) * len(T)\n        pbar = tqdm(total=total, desc=\"imputation.carry_forward\", disable=Config.TQDM_DISABLE)\n\n    new = T.copy()\n    for name in T.columns:\n        if name in targets:\n            data = T[name][:]  # create copy\n            last_value = None\n            for ix, v in enumerate(data):\n                if v in missing:  # perform replacement\n                    data[ix] = last_value\n                else:  # keep last value.\n                    last_value = v\n                pbar.update(1)\n            new[name] = data\n        else:\n            new[name] = T[name]\n\n    return new\n</code></pre>"},{"location":"reference/imputation/#tablite.imputation.stats_method","title":"<code>tablite.imputation.stats_method(T, targets, missing, method, tqdm=_tqdm, pbar=None)</code>","text":"Source code in <code>tablite/imputation.py</code> <pre><code>def stats_method(T, targets, missing, method, tqdm=_tqdm, pbar=None):\n    assert isinstance(missing, set)\n\n    if pbar is None:\n        total = len(targets)\n        pbar = tqdm(total=total, desc=f\"imputation.{method}\", disable=Config.TQDM_DISABLE)\n\n    new = T.copy()\n    for name in T.columns:\n        if name in targets:\n            col = T.columns[name]\n            assert isinstance(col, Column)\n\n            hist_values, hist_counts = col.histogram()\n\n            for m in missing:\n                try:\n                    idx = hist_values.index(m)\n                    hist_counts[idx] = 0\n                except ValueError:\n                    pass\n\n            stats = summary_statistics(hist_values, hist_counts)\n\n            new_value = stats[method]\n            col.replace(mapping={m: new_value for m in missing})\n            new[name] = col\n            pbar.update(1)\n        else:\n            new[name] = T[name]  # no entropy, keep as is.\n\n    return new\n</code></pre>"},{"location":"reference/imputation/#tablite.imputation-modules","title":"Modules","text":""},{"location":"reference/joins/","title":"Joins","text":""},{"location":"reference/joins/#tablite.joins","title":"<code>tablite.joins</code>","text":""},{"location":"reference/joins/#tablite.joins-classes","title":"Classes","text":""},{"location":"reference/joins/#tablite.joins-functions","title":"Functions","text":""},{"location":"reference/joins/#tablite.joins.join","title":"<code>tablite.joins.join(T: BaseTable, other: BaseTable, left_keys: List[str], right_keys: List[str], left_columns: Union[List[str], None], right_columns: Union[List[str], None], kind: str = 'inner', merge_keys: bool = False, tqdm=_tqdm, pbar=None)</code>","text":"<p>short-cut for all join functions.</p> PARAMETER  DESCRIPTION <code>T</code> <p>left table</p> <p> TYPE: <code>Table</code> </p> <code>other</code> <p>right table</p> <p> TYPE: <code>Table</code> </p> <code>left_keys</code> <p>list of keys for the join from left table.</p> <p> TYPE: <code>list</code> </p> <code>right_keys</code> <p>list of keys for the join from right table.</p> <p> TYPE: <code>list</code> </p> <code>left_columns</code> <p>list of columns names to retain from left table. If None, all are retained.</p> <p> TYPE: <code>list</code> </p> <code>right_columns</code> <p>list of columns names to retain from right table. If None, all are retained.</p> <p> TYPE: <code>list</code> </p> <code>kind</code> <p>'inner', 'left', 'outer', 'cross'. Defaults to \"inner\".</p> <p> TYPE: <code>str</code> DEFAULT: <code>'inner'</code> </p> <code>tqdm</code> <p>tqdm progress counter. Defaults to _tqdm.</p> <p> TYPE: <code>tqdm</code> DEFAULT: <code>tqdm</code> </p> <code>pbar</code> <p>tqdm.progressbar. Defaults to None.</p> <p> TYPE: <code>pbar</code> DEFAULT: <code>None</code> </p> RAISES DESCRIPTION <code>ValueError</code> <p>if join type is unknown.</p> RETURNS DESCRIPTION <code>Table</code> <p>joined table.</p> <p>Example: \"inner\"</p> <pre><code>SQL:   SELECT number, letter FROM numbers JOIN letters ON numbers.colour == letters.color\n</code></pre> <p>Tablite: </p> <pre><code>&gt;&gt;&gt; inner_join = numbers.inner_join(\n    letters, \n    left_keys=['colour'], \n    right_keys=['color'], \n    left_columns=['number'], \n    right_columns=['letter']\n)\n</code></pre> <p>Example: \"left\" </p> <pre><code>SQL:   SELECT number, letter FROM numbers LEFT JOIN letters ON numbers.colour == letters.color\n</code></pre> <p>Tablite: </p> <pre><code>&gt;&gt;&gt; left_join = numbers.left_join(\n    letters, \n    left_keys=['colour'], \n    right_keys=['color'], \n    left_columns=['number'], \n    right_columns=['letter']\n)\n</code></pre> <p>Example: \"outer\"</p> <pre><code>SQL:   SELECT number, letter FROM numbers OUTER JOIN letters ON numbers.colour == letters.color\n</code></pre> <p>Tablite: </p> <pre><code>&gt;&gt;&gt; outer_join = numbers.outer_join(\n    letters, \n    left_keys=['colour'], \n    right_keys=['color'], \n    left_columns=['number'], \n    right_columns=['letter']\n    )\n</code></pre> <p>Example: \"cross\"</p> <p>CROSS JOIN returns the Cartesian product of rows from tables in the join. In other words, it will produce rows which combine each row from the first table with each row from the second table</p> Source code in <code>tablite/joins.py</code> <pre><code>def join(\n    T: BaseTable,\n    other: BaseTable,\n    left_keys: List[str],\n    right_keys: List[str],\n    left_columns: Union[List[str], None],\n    right_columns: Union[List[str], None],\n    kind: str = \"inner\",\n    merge_keys: bool = False,\n    tqdm=_tqdm,\n    pbar=None,\n):\n    \"\"\"short-cut for all join functions.\n\n    Args:\n        T (Table): left table\n        other (Table): right table\n        left_keys (list): list of keys for the join from left table.\n        right_keys (list): list of keys for the join from right table.\n        left_columns (list): list of columns names to retain from left table.\n            If None, all are retained.\n        right_columns (list): list of columns names to retain from right table.\n            If None, all are retained.\n        kind (str, optional): 'inner', 'left', 'outer', 'cross'. Defaults to \"inner\".\n        tqdm (tqdm, optional): tqdm progress counter. Defaults to _tqdm.\n        pbar (tqdm.pbar, optional): tqdm.progressbar. Defaults to None.\n\n    Raises:\n        ValueError: if join type is unknown.\n\n    Returns:\n        Table: joined table.\n\n    Example: \"inner\"\n    ```\n    SQL:   SELECT number, letter FROM numbers JOIN letters ON numbers.colour == letters.color\n    ```\n    Tablite: \n    ```\n    &gt;&gt;&gt; inner_join = numbers.inner_join(\n        letters, \n        left_keys=['colour'], \n        right_keys=['color'], \n        left_columns=['number'], \n        right_columns=['letter']\n    )\n    ```\n\n    Example: \"left\" \n    ```\n    SQL:   SELECT number, letter FROM numbers LEFT JOIN letters ON numbers.colour == letters.color\n    ```\n    Tablite: \n    ```\n    &gt;&gt;&gt; left_join = numbers.left_join(\n        letters, \n        left_keys=['colour'], \n        right_keys=['color'], \n        left_columns=['number'], \n        right_columns=['letter']\n    )\n    ```\n\n    Example: \"outer\"\n    ```\n    SQL:   SELECT number, letter FROM numbers OUTER JOIN letters ON numbers.colour == letters.color\n    ```\n\n    Tablite: \n    ```\n    &gt;&gt;&gt; outer_join = numbers.outer_join(\n        letters, \n        left_keys=['colour'], \n        right_keys=['color'], \n        left_columns=['number'], \n        right_columns=['letter']\n        )\n    ```\n\n    Example: \"cross\"\n\n    CROSS JOIN returns the Cartesian product of rows from tables in the join.\n    In other words, it will produce rows which combine each row from the first table\n    with each row from the second table\n    \"\"\"\n    if left_columns is None:\n        left_columns = list(T.columns)\n    if right_columns is None:\n        right_columns = list(other.columns)\n    assert merge_keys in {True,False}\n\n    _jointype_check(T, other, left_keys, right_keys, left_columns, right_columns)\n\n    return _join(kind, T,other,left_keys, right_keys, left_columns, right_columns, merge_keys=merge_keys,\n             tqdm=tqdm, pbar=pbar)\n</code></pre>"},{"location":"reference/joins/#tablite.joins.inner_join","title":"<code>tablite.joins.inner_join(T: BaseTable, other: BaseTable, left_keys: List[str], right_keys: List[str], left_columns: Union[List[str], None], right_columns: Union[List[str], None], merge_keys: bool = False, tqdm=_tqdm, pbar=None)</code>","text":"Source code in <code>tablite/joins.py</code> <pre><code>def inner_join(T: BaseTable, other: BaseTable, left_keys: List[str], right_keys: List[str], \n              left_columns: Union[List[str], None], right_columns: Union[List[str], None],\n              merge_keys: bool = False, tqdm=_tqdm, pbar=None):\n    return join(T, other, left_keys, right_keys, left_columns, right_columns, kind=\"inner\", merge_keys=merge_keys, tqdm=tqdm,pbar=pbar)\n</code></pre>"},{"location":"reference/joins/#tablite.joins.left_join","title":"<code>tablite.joins.left_join(T: BaseTable, other: BaseTable, left_keys: List[str], right_keys: List[str], left_columns: Union[List[str], None], right_columns: Union[List[str], None], merge_keys: bool = False, tqdm=_tqdm, pbar=None)</code>","text":"Source code in <code>tablite/joins.py</code> <pre><code>def left_join(T: BaseTable, other: BaseTable, left_keys: List[str], right_keys: List[str], \n              left_columns: Union[List[str], None], right_columns: Union[List[str], None],\n              merge_keys: bool = False, tqdm=_tqdm, pbar=None):\n    return join(T, other, left_keys, right_keys, left_columns, right_columns, kind=\"left\", merge_keys=merge_keys, tqdm=tqdm,pbar=pbar)\n</code></pre>"},{"location":"reference/joins/#tablite.joins.outer_join","title":"<code>tablite.joins.outer_join(T: BaseTable, other: BaseTable, left_keys: List[str], right_keys: List[str], left_columns: Union[List[str], None], right_columns: Union[List[str], None], merge_keys: bool = False, tqdm=_tqdm, pbar=None)</code>","text":"Source code in <code>tablite/joins.py</code> <pre><code>def outer_join(T: BaseTable, other: BaseTable, left_keys: List[str], right_keys: List[str], \n              left_columns: Union[List[str], None], right_columns: Union[List[str], None],\n              merge_keys: bool = False, tqdm=_tqdm, pbar=None):\n    return join(T, other, left_keys, right_keys, left_columns, right_columns, kind=\"outer\", merge_keys=merge_keys, tqdm=tqdm,pbar=pbar)\n</code></pre>"},{"location":"reference/joins/#tablite.joins.cross_join","title":"<code>tablite.joins.cross_join(T: BaseTable, other: BaseTable, left_keys: List[str], right_keys: List[str], left_columns: Union[List[str], None], right_columns: Union[List[str], None], merge_keys: bool = False, tqdm=_tqdm, pbar=None)</code>","text":"Source code in <code>tablite/joins.py</code> <pre><code>def cross_join(T: BaseTable, other: BaseTable, left_keys: List[str], right_keys: List[str], \n              left_columns: Union[List[str], None], right_columns: Union[List[str], None],\n              merge_keys: bool = False, tqdm=_tqdm, pbar=None):\n    return join(T, other, left_keys, right_keys, left_columns, right_columns, kind=\"cross\", merge_keys=merge_keys, tqdm=tqdm,pbar=pbar)\n</code></pre>"},{"location":"reference/lookup/","title":"Lookup","text":""},{"location":"reference/lookup/#tablite.lookup","title":"<code>tablite.lookup</code>","text":""},{"location":"reference/lookup/#tablite.lookup-attributes","title":"Attributes","text":""},{"location":"reference/lookup/#tablite.lookup-classes","title":"Classes","text":""},{"location":"reference/lookup/#tablite.lookup-functions","title":"Functions","text":""},{"location":"reference/lookup/#tablite.lookup.lookup","title":"<code>tablite.lookup.lookup(T, other, *criteria, all=True, tqdm=_tqdm)</code>","text":"<p>function for looking up values in <code>other</code> according to criteria in ascending order. :param: T: Table  :param: other: Table sorted in ascending search order. :param: criteria: Each criteria must be a tuple with value comparisons in the form:     (LEFT, OPERATOR, RIGHT) :param: all: boolean: True=ALL, False=ANY</p> <p>OPERATOR must be a callable that returns a boolean LEFT must be a value that the OPERATOR can compare. RIGHT must be a value that the OPERATOR can compare.</p> <p>Examples:</p> <p>comparison of two columns:</p> <pre><code>('column A', \"==\", 'column B')\n</code></pre> <p>compare value from column 'Date' with date 24/12.</p> <pre><code>('Date', \"&lt;\", DataTypes.date(24,12) )\n</code></pre> <p>uses custom function to compare value from column 'text 1' with value from column 'text 2'</p> <pre><code>f = lambda L,R: all( ord(L) &lt; ord(R) )\n('text 1', f, 'text 2')\n</code></pre> Source code in <code>tablite/lookup.py</code> <pre><code>def lookup(T, other, *criteria, all=True, tqdm=_tqdm):\n    \"\"\"function for looking up values in `other` according to criteria in ascending order.\n    :param: T: Table \n    :param: other: Table sorted in ascending search order.\n    :param: criteria: Each criteria must be a tuple with value comparisons in the form:\n        (LEFT, OPERATOR, RIGHT)\n    :param: all: boolean: True=ALL, False=ANY\n\n    OPERATOR must be a callable that returns a boolean\n    LEFT must be a value that the OPERATOR can compare.\n    RIGHT must be a value that the OPERATOR can compare.\n\n    Examples:\n        comparison of two columns:\n\n            ('column A', \"==\", 'column B')\n\n        compare value from column 'Date' with date 24/12.\n\n            ('Date', \"&lt;\", DataTypes.date(24,12) )\n\n        uses custom function to compare value from column\n        'text 1' with value from column 'text 2'\n\n            f = lambda L,R: all( ord(L) &lt; ord(R) )\n            ('text 1', f, 'text 2')\n\n    \"\"\"\n    sub_cls_check(T, BaseTable)\n    sub_cls_check(other, BaseTable)\n\n    all = all\n    any = not all\n\n    ops = lookup_ops\n\n    functions, left_criteria, right_criteria = [], set(), set()\n\n    for left, op, right in criteria:\n        left_criteria.add(left)\n        right_criteria.add(right)\n        if callable(op):\n            pass  # it's a custom function.\n        else:\n            op = ops.get(op, None)\n            if not callable(op):\n                raise ValueError(f\"{op} not a recognised operator for comparison.\")\n\n        functions.append((op, left, right))\n    left_columns = [n for n in left_criteria if n in T.columns]\n    right_columns = [n for n in right_criteria if n in other.columns]\n\n    result_index = np.empty(shape=(len(T)), dtype=np.int64)\n    cache = {}\n    left = T[left_columns]\n    Constr = type(T)\n    if isinstance(left, Column):\n        tmp, left = left, Constr()\n        left[left_columns[0]] = tmp\n    right = other[right_columns]\n    if isinstance(right, Column):\n        tmp, right = right, Constr()\n        right[right_columns[0]] = tmp\n    assert isinstance(left, BaseTable)\n    assert isinstance(right, BaseTable)\n\n    for ix, row1 in tqdm(enumerate(left.rows), total=len(T), disable=Config.TQDM_DISABLE):\n        row1_tup = tuple(row1)\n        row1d = {name: value for name, value in zip(left_columns, row1)}\n        row1_hash = hash(row1_tup)\n\n        match_found = True if row1_hash in cache else False\n\n        if not match_found:  # search.\n            for row2ix, row2 in enumerate(right.rows):\n                row2d = {name: value for name, value in zip(right_columns, row2)}\n\n                evaluations = {op(row1d.get(left, left), row2d.get(right, right)) for op, left, right in functions}\n                # The evaluations above does a neat trick:\n                # as L is a dict, L.get(left, L) will return a value\n                # from the columns IF left is a column name. If it isn't\n                # the function will treat left as a value.\n                # The same applies to right.\n                all_ = all and (False not in evaluations)\n                any_ = any and True in evaluations\n                if all_ or any_:\n                    match_found = True\n                    cache[row1_hash] = row2ix\n                    break\n\n        if not match_found:  # no match found.\n            cache[row1_hash] = -1  # -1 is replacement for None in the index as numpy can't handle Nones.\n\n        result_index[ix] = cache[row1_hash]\n\n    f = select_processing_method(2 * max(len(T), len(other)), _sp_lookup, _mp_lookup)\n    return f(T, other, result_index)\n</code></pre>"},{"location":"reference/match/","title":"Match","text":""},{"location":"reference/match/#tablite.match","title":"<code>tablite.match</code>","text":""},{"location":"reference/match/#tablite.match-classes","title":"Classes","text":""},{"location":"reference/match/#tablite.match-functions","title":"Functions","text":""},{"location":"reference/match/#tablite.match.match","title":"<code>tablite.match.match(T, other, *criteria, keep_left=None, keep_right=None)</code>","text":"<p>performs inner join where <code>T</code> matches <code>other</code> and removes rows that do not match.</p> <p>:param: T: Table :param: other: Table :param: criteria: Each criteria must be a tuple with value comparisons in the form:</p> <pre><code>(LEFT, OPERATOR, RIGHT), where operator must be \"==\"\n\nExample:\n    ('column A', \"==\", 'column B')\n\nThis syntax follows the lookup syntax. See Lookup for details.\n</code></pre> <p>:param: keep_left: list of columns to keep. :param: keep_right: list of right columns to keep.</p> Source code in <code>tablite/match.py</code> <pre><code>def match(T, other, *criteria, keep_left=None, keep_right=None):  # lookup and filter combined - drops unmatched rows.\n    \"\"\"\n    performs inner join where `T` matches `other` and removes rows that do not match.\n\n    :param: T: Table\n    :param: other: Table\n    :param: criteria: Each criteria must be a tuple with value comparisons in the form:\n\n        (LEFT, OPERATOR, RIGHT), where operator must be \"==\"\n\n        Example:\n            ('column A', \"==\", 'column B')\n\n        This syntax follows the lookup syntax. See Lookup for details.\n\n    :param: keep_left: list of columns to keep.\n    :param: keep_right: list of right columns to keep.\n    \"\"\"\n    assert isinstance(T, BaseTable)\n    assert isinstance(other, BaseTable)\n    if keep_left is None:\n        keep_left = [n for n in T.columns]\n    else:\n        type_check(keep_left, list)\n        name_check(T.columns, *keep_left)\n\n    if keep_right is None:\n        keep_right = [n for n in other.columns]\n    else:\n        type_check(keep_right, list)\n        name_check(other.columns, *keep_right)\n\n    indices = np.full(shape=(len(T),), fill_value=-1, dtype=np.int64)\n    for arg in criteria:\n        b,_,a = arg\n        if _ != \"==\":\n            raise ValueError(\"match requires A == B. For other logic visit `lookup`\")\n        if b not in T.columns:\n            raise ValueError(f\"Column {b} not found in T for criteria: {arg}\")\n        if a not in other.columns:\n            raise ValueError(f\"Column {a} not found in T for criteria: {arg}\")\n\n        index_update = find_indices(other[a][:], T[b][:], fill_value=-1)\n        indices = merge_indices(indices, index_update)\n\n    cls = type(T)\n    new = cls()\n    for name in T.columns:\n        if name in keep_left:\n            new[name] = np.compress(indices != -1, T[name][:])\n\n    for name in other.columns:\n        if name in keep_right:\n            new_name = unique_name(name, new.columns)\n            primary = np.compress(indices != -1, indices)\n            new[new_name] = np.take(other[name][:], primary)\n\n    return new\n</code></pre>"},{"location":"reference/match/#tablite.match.find_indices","title":"<code>tablite.match.find_indices(x, y, fill_value=-1)</code>","text":"<p>finds index of y in x</p> Source code in <code>tablite/match.py</code> <pre><code>def find_indices(x,y, fill_value=-1):  # fast.\n    \"\"\"\n    finds index of y in x\n    \"\"\"\n    # disassembly of numpy:\n    # import numpy as np\n    # x = np.array([3, 5, 7,  1,   9, 8, 6, 6])\n    # y = np.array([2, 1, 5, 10, 100, 6])\n    index = np.argsort(x)  # array([3, 0, 1, 6, 7, 2, 5, 4])\n    sorted_x = x[index]  # array([1, 3, 5, 6, 6, 7, 8, 9])\n    sorted_index = np.searchsorted(sorted_x, y)  # array([1, 0, 2, 8, 8, 3])\n    yindex = np.take(index, sorted_index, mode=\"clip\")  # array([0, 3, 1, 4, 4, 6])\n    mask = x[yindex] != y  # array([ True, False, False,  True,  True, False])\n    indices = np.ma.array(yindex, mask=mask, fill_value=fill_value)  \n    # masked_array(data=[--, 3, 1, --, --, 6], mask=[ True, False, False,  True,  True, False], fill_value=999999)\n    # --: y[0] not in x\n    # 3 : y[1] == x[3]\n    # 1 : y[2] == x[1]\n    # --: y[3] not in x\n    # --: y[4] not in x\n    # --: y[5] == x[6]\n    result = np.where(~indices.mask, indices.data, -1)  \n    return result  # array([-1,  3,  1, -1, -1,  6])\n</code></pre>"},{"location":"reference/match/#tablite.match.merge_indices","title":"<code>tablite.match.merge_indices(x1, *args, fill_value=-1)</code>","text":"<p>merges x1 and x2 where</p> Source code in <code>tablite/match.py</code> <pre><code>def merge_indices(x1, *args, fill_value=-1):\n    \"\"\"\n    merges x1 and x2 where \n    \"\"\"\n    # dis:\n    # &gt;&gt;&gt; AA = array([-1,  3, -1, 5])\n    # &gt;&gt;&gt; BB = array([-1, -1,  4, 5])\n    new = x1[:]  # = AA\n    for arg in args:\n        mask = (new == fill_value)  # array([True, False, True, False])\n        new = np.where(mask, arg, new)  # array([-1, 3, 4, 5])\n    return new   # array([-1, 3, 4, 5])\n</code></pre>"},{"location":"reference/merge/","title":"Merge","text":""},{"location":"reference/merge/#tablite.merge","title":"<code>tablite.merge</code>","text":""},{"location":"reference/merge/#tablite.merge-classes","title":"Classes","text":""},{"location":"reference/merge/#tablite.merge-functions","title":"Functions","text":""},{"location":"reference/merge/#tablite.merge.where","title":"<code>tablite.merge.where(T, criteria, left, right, new)</code>","text":"<p>takes from LEFT where criteria is True else RIGHT  and creates a single new column.</p> <p>:param: T: Table :param: criteria: np.array(bool):          if True take left column         else take right column :param left: (str) column name :param right: (str) column name :param new: (str) new name</p> <p>:returns: T</p> Source code in <code>tablite/merge.py</code> <pre><code>def where(T, criteria, left, right, new):\n    \"\"\" takes from LEFT where criteria is True else RIGHT \n    and creates a single new column.\n\n    :param: T: Table\n    :param: criteria: np.array(bool): \n            if True take left column\n            else take right column\n    :param left: (str) column name\n    :param right: (str) column name\n    :param new: (str) new name\n\n    :returns: T\n    \"\"\"\n    type_check(T, BaseTable)\n    if isinstance(criteria, np.ndarray):\n        if not criteria.dtype == \"bool\":\n            raise TypeError\n    else:\n        criteria = np.array(criteria, dtype='bool')\n\n    new_uq = unique_name(new, list(T.columns))\n    T.add_column(new_uq)\n    col = T[new_uq]\n\n    for start,end in Config.page_steps(len(criteria)):\n        left_values = T[left][start:end]\n        right_values = T[right][start:end]\n        new_values = np.where(criteria, left_values, right_values)\n        col.extend(new_values)\n\n    if new == right:\n        T[right] = T[new_uq]  # keep column order\n        del T[new_uq]\n        del T[left]\n    elif new == left:\n        T[left] = T[new_uq]  # keep column order\n        del T[new_uq]\n        del T[right]\n    else:\n        T[new] = T[new_uq]\n        del T[left]\n        del T[right]\n    return T\n</code></pre>"},{"location":"reference/mp_utils/","title":"Mp utils","text":""},{"location":"reference/mp_utils/#tablite.mp_utils","title":"<code>tablite.mp_utils</code>","text":""},{"location":"reference/mp_utils/#tablite.mp_utils-attributes","title":"Attributes","text":""},{"location":"reference/mp_utils/#tablite.mp_utils.lookup_ops","title":"<code>tablite.mp_utils.lookup_ops = {'in': _in, 'not in': not_in, '&lt;': operator.lt, '&lt;=': operator.le, '&gt;': operator.gt, '&gt;=': operator.ge, '!=': operator.ne, '==': operator.eq}</code>  <code>module-attribute</code>","text":""},{"location":"reference/mp_utils/#tablite.mp_utils.filter_ops","title":"<code>tablite.mp_utils.filter_ops = {'&gt;': operator.gt, '&gt;=': operator.ge, '==': operator.eq, '&lt;': operator.lt, '&lt;=': operator.le, '!=': operator.ne, 'in': _in}</code>  <code>module-attribute</code>","text":""},{"location":"reference/mp_utils/#tablite.mp_utils.filter_ops_from_text","title":"<code>tablite.mp_utils.filter_ops_from_text = {'gt': '&gt;', 'gteq': '&gt;=', 'eq': '==', 'lt': '&lt;', 'lteq': '&lt;=', 'neq': '!=', 'in': _in}</code>  <code>module-attribute</code>","text":""},{"location":"reference/mp_utils/#tablite.mp_utils-classes","title":"Classes","text":""},{"location":"reference/mp_utils/#tablite.mp_utils-functions","title":"Functions","text":""},{"location":"reference/mp_utils/#tablite.mp_utils.not_in","title":"<code>tablite.mp_utils.not_in(a, b)</code>","text":"Source code in <code>tablite/mp_utils.py</code> <pre><code>def not_in(a, b):\n    return not operator.contains(str(a), str(b))\n</code></pre>"},{"location":"reference/mp_utils/#tablite.mp_utils.is_mp","title":"<code>tablite.mp_utils.is_mp(fields: int) -&gt; bool</code>","text":"PARAMETER  DESCRIPTION <code>fields</code> <p>number of fields</p> <p> TYPE: <code>int</code> </p> RETURNS DESCRIPTION <code>bool</code> <p>bool</p> Source code in <code>tablite/mp_utils.py</code> <pre><code>def is_mp(fields: int) -&gt; bool:\n    \"\"\"\n\n    Args:\n        fields (int): number of fields\n\n    Returns:\n        bool\n    \"\"\"\n    if Config.MULTIPROCESSING_MODE == Config.FORCE:\n        return True\n\n    if Config.MULTIPROCESSING_MODE == Config.FALSE:\n        return False\n\n    if fields &lt; Config.SINGLE_PROCESSING_LIMIT:\n        return False\n\n    if max(psutil.cpu_count(logical=False), 1) &lt; 2:\n        return False\n\n    return True\n</code></pre>"},{"location":"reference/mp_utils/#tablite.mp_utils.select_processing_method","title":"<code>tablite.mp_utils.select_processing_method(fields, sp, mp)</code>","text":"PARAMETER  DESCRIPTION <code>fields</code> <p>number of fields</p> <p> TYPE: <code>int</code> </p> <code>sp</code> <p>method for single processing</p> <p> TYPE: <code>callable</code> </p> <code>mp</code> <p>method for multiprocessing</p> <p> TYPE: <code>callable</code> </p> RETURNS DESCRIPTION <code>_type_</code> <p>description</p> Source code in <code>tablite/mp_utils.py</code> <pre><code>def select_processing_method(fields, sp, mp):\n    \"\"\"\n\n    Args:\n        fields (int): number of fields\n        sp (callable): method for single processing\n        mp (callable): method for multiprocessing\n\n    Returns:\n        _type_: _description_\n    \"\"\"\n    return mp if is_mp(fields) else sp\n</code></pre>"},{"location":"reference/mp_utils/#tablite.mp_utils.maskify","title":"<code>tablite.mp_utils.maskify(arr)</code>","text":"Source code in <code>tablite/mp_utils.py</code> <pre><code>def maskify(arr):\n    none_mask = [False] * len(arr)  # Setting the default\n\n    for i in range(len(arr)):\n        if arr[i] is None:  # Check if our value is None\n            none_mask[i] = True\n            arr[i] = 0  # Remove None from the original array\n\n    return none_mask\n</code></pre>"},{"location":"reference/mp_utils/#tablite.mp_utils.share_mem","title":"<code>tablite.mp_utils.share_mem(inp_arr, dtype)</code>","text":"Source code in <code>tablite/mp_utils.py</code> <pre><code>def share_mem(inp_arr, dtype):\n    len_ = len(inp_arr)\n    size = np.dtype(dtype).itemsize * len_\n    shape = (len_,)\n\n    out_shm = shared_memory.SharedMemory(create=True, size=size)  # the co_processors will read this.\n    out_arr_index = np.ndarray(shape, dtype=dtype, buffer=out_shm.buf)\n    out_arr_index[:] = inp_arr\n\n    return out_arr_index, out_shm\n</code></pre>"},{"location":"reference/mp_utils/#tablite.mp_utils.map_task","title":"<code>tablite.mp_utils.map_task(data_shm_name, index_shm_name, destination_shm_name, shape, dtype, start, end)</code>","text":"Source code in <code>tablite/mp_utils.py</code> <pre><code>def map_task(data_shm_name, index_shm_name, destination_shm_name, shape, dtype, start, end):\n    # connect\n    shared_data = shared_memory.SharedMemory(name=data_shm_name)\n    data = np.ndarray(shape, dtype=dtype, buffer=shared_data.buf)\n\n    shared_index = shared_memory.SharedMemory(name=index_shm_name)\n    index = np.ndarray(shape, dtype=np.int64, buffer=shared_index.buf)\n\n    shared_target = shared_memory.SharedMemory(name=destination_shm_name)\n    target = np.ndarray(shape, dtype=dtype, buffer=shared_target.buf)\n    # work\n    target[start:end] = np.take(data[start:end], index[start:end])\n    # disconnect\n    shared_data.close()\n    shared_index.close()\n    shared_target.close()\n</code></pre>"},{"location":"reference/mp_utils/#tablite.mp_utils.reindex_task","title":"<code>tablite.mp_utils.reindex_task(src, dst, index_shm, shm_shape, start, end)</code>","text":"Source code in <code>tablite/mp_utils.py</code> <pre><code>def reindex_task(src, dst, index_shm, shm_shape, start, end):\n    # connect\n    existing_shm = shared_memory.SharedMemory(name=index_shm)\n    shared_index = np.ndarray(shm_shape, dtype=np.int64, buffer=existing_shm.buf)\n    # work\n    array = load_numpy(src)\n    new = np.take(array, shared_index[start:end])\n    np.save(dst, new, allow_pickle=True, fix_imports=False)\n    # disconnect\n    existing_shm.close()\n</code></pre>"},{"location":"reference/nimlite/","title":"Nimlite","text":""},{"location":"reference/nimlite/#tablite.nimlite","title":"<code>tablite.nimlite</code>","text":""},{"location":"reference/nimlite/#tablite.nimlite-attributes","title":"Attributes","text":""},{"location":"reference/nimlite/#tablite.nimlite.paths","title":"<code>tablite.nimlite.paths = sys.argv[:]</code>  <code>module-attribute</code>","text":""},{"location":"reference/nimlite/#tablite.nimlite.K","title":"<code>tablite.nimlite.K = TypeVar('K', bound=BaseTable)</code>  <code>module-attribute</code>","text":""},{"location":"reference/nimlite/#tablite.nimlite.ValidEncoders","title":"<code>tablite.nimlite.ValidEncoders = Literal['ENC_UTF8', 'ENC_UTF16', 'ENC_WIN1250']</code>  <code>module-attribute</code>","text":""},{"location":"reference/nimlite/#tablite.nimlite.ValidQuoting","title":"<code>tablite.nimlite.ValidQuoting = Literal['QUOTE_MINIMAL', 'QUOTE_ALL', 'QUOTE_NONNUMERIC', 'QUOTE_NONE', 'QUOTE_STRINGS', 'QUOTE_NOTNULL']</code>  <code>module-attribute</code>","text":""},{"location":"reference/nimlite/#tablite.nimlite.ValidSkipEmpty","title":"<code>tablite.nimlite.ValidSkipEmpty = Literal['NONE', 'ANY', 'ALL']</code>  <code>module-attribute</code>","text":""},{"location":"reference/nimlite/#tablite.nimlite.ColumnSelectorDict","title":"<code>tablite.nimlite.ColumnSelectorDict = TypedDict('ColumnSelectorDict', {'column': str, 'type': Literal['int', 'float', 'bool', 'str', 'date', 'time', 'datetime'], 'allow_empty': Union[bool, None], 'rename': Union[str, None]})</code>  <code>module-attribute</code>","text":""},{"location":"reference/nimlite/#tablite.nimlite.FilterCriteria","title":"<code>tablite.nimlite.FilterCriteria = Literal['&gt;', '&gt;=', '==', '&lt;', '&lt;=', '!=', 'in']</code>  <code>module-attribute</code>","text":""},{"location":"reference/nimlite/#tablite.nimlite.FilterType","title":"<code>tablite.nimlite.FilterType = Literal['all', 'any']</code>  <code>module-attribute</code>","text":""},{"location":"reference/nimlite/#tablite.nimlite.FilterDict","title":"<code>tablite.nimlite.FilterDict = TypedDict('FilterDict', {'column1': str, 'value1': Union[str, None], 'criteria': FilterCriteria, 'column2': str, 'value2': Union[str, None]})</code>  <code>module-attribute</code>","text":""},{"location":"reference/nimlite/#tablite.nimlite-classes","title":"Classes","text":""},{"location":"reference/nimlite/#tablite.nimlite-functions","title":"Functions","text":""},{"location":"reference/nimlite/#tablite.nimlite.get_headers","title":"<code>tablite.nimlite.get_headers(path: Union[str, Path], encoding: ValidEncoders = 'ENC_UTF8', *, header_row_index: int = 0, newline: str = '\\n', delimiter: str = ',', text_qualifier: str = '\"', quoting: ValidQuoting, strip_leading_and_tailing_whitespace: bool = True, linecount: int = 10) -&gt; list[list[str]]</code>","text":"Source code in <code>tablite/nimlite.py</code> <pre><code>def get_headers(\n    path: Union[str, Path],\n    encoding: ValidEncoders =\"ENC_UTF8\",\n    *,\n    header_row_index: int=0,\n    newline: str='\\n', delimiter: str=',', text_qualifier: str='\"',\n    quoting: ValidQuoting, strip_leading_and_tailing_whitespace: bool=True,\n    linecount: int = 10\n) -&gt; list[list[str]]:\n    return nl.get_headers(\n            path=str(path),\n            encoding=encoding,\n            newline=newline, delimiter=delimiter, text_qualifier=text_qualifier,\n            strip_leading_and_tailing_whitespace=strip_leading_and_tailing_whitespace,\n            header_row_index=header_row_index,\n            quoting=quoting,\n            linecount=linecount\n        )\n</code></pre>"},{"location":"reference/nimlite/#tablite.nimlite.text_reader","title":"<code>tablite.nimlite.text_reader(T: Type[K], pid: str, path: Union[str, Path], encoding: ValidEncoders = 'ENC_UTF8', *, first_row_has_headers: bool = True, header_row_index: int = 0, columns: List[Union[str, None]] = None, start: Union[str, None] = None, limit: Union[str, None] = None, guess_datatypes: bool = False, newline: str = '\\n', delimiter: str = ',', text_qualifier: str = '\"', quoting: ValidQuoting, strip_leading_and_tailing_whitespace: bool = True, skip_empty: ValidSkipEmpty = 'NONE', tqdm=_tqdm) -&gt; K</code>","text":"Source code in <code>tablite/nimlite.py</code> <pre><code>def text_reader(\n    T: Type[K],\n    pid: str, path: Union[str, Path],\n    encoding: ValidEncoders =\"ENC_UTF8\",\n    *,\n    first_row_has_headers: bool=True, header_row_index: int=0,\n    columns: List[Union[str, None]]=None,\n    start: Union[str, None] = None, limit: Union[str, None]=None,\n    guess_datatypes: bool =False,\n    newline: str='\\n', delimiter: str=',', text_qualifier: str='\"',\n    quoting: ValidQuoting, strip_leading_and_tailing_whitespace: bool=True, skip_empty: ValidSkipEmpty = \"NONE\",\n    tqdm=_tqdm\n) -&gt; K:\n    assert isinstance(path, Path)\n    assert isinstance(pid, Path)\n    with tqdm(total=10, desc=f\"importing file\") as pbar:\n        table = nl.text_reader(\n            pid=str(pid),\n            path=str(path),\n            encoding=encoding,\n            first_row_has_headers=first_row_has_headers, header_row_index=header_row_index,\n            columns=columns,\n            start=start, limit=limit,\n            guess_datatypes=guess_datatypes,\n            newline=newline, delimiter=delimiter, text_qualifier=text_qualifier,\n            quoting=quoting,\n            strip_leading_and_tailing_whitespace=strip_leading_and_tailing_whitespace,\n            skip_empty=skip_empty,\n            page_size=Config.PAGE_SIZE\n        )\n\n        pbar.update(1)\n\n        task_info = table[\"task\"]\n        task_columns = table[\"columns\"]\n\n        ti_tasks = task_info[\"tasks\"]\n        ti_import_field_names = task_info[\"import_field_names\"]\n\n        is_windows = platform.system() == \"Windows\"\n        use_logical = False if is_windows else True\n\n        cpus = max(psutil.cpu_count(logical=use_logical), 1)\n\n        pbar_step = 4 / max(len(ti_tasks), 1)\n\n        class WrapUpdate:\n            def update(self, n):\n                pbar.update(n * pbar_step)\n\n        wrapped_pbar = WrapUpdate()\n\n        def next_task(task: Task, page_info):\n            wrapped_pbar.update(1)\n            return Task(\n                nl.text_reader_task,\n                *task.args, **task.kwargs, page_info=page_info\n            )\n\n        tasks = [\n            TaskChain(\n                Task(\n                    nl.collect_text_reader_page_info_task,\n                    task=t,\n                    task_info=task_info\n                ), next_task=next_task\n            ) for t in ti_tasks\n        ]\n\n        is_sp = False\n\n        if Config.MULTIPROCESSING_MODE == Config.FALSE:\n            is_sp = True\n        elif Config.MULTIPROCESSING_MODE == Config.FORCE:\n            is_sp = False\n        elif Config.MULTIPROCESSING_MODE == Config.AUTO and cpus &lt;= 1 or len(tasks) &lt;= 1:\n            is_sp = True\n\n        if is_sp:\n            res = []\n\n            for task in tasks:\n                page = task.execute()\n\n                res.append(page)\n        else:\n            with TaskManager(cpus, error_mode=\"exception\") as tm:\n                res = tm.execute(tasks, pbar=wrapped_pbar)\n\n        col_path = pid\n        column_dict = {\n            cols: Column(col_path)\n            for cols in ti_import_field_names\n        }\n\n        for res_pages in res:\n            col_map = {\n                n: res_pages[i]\n                for i, n in enumerate(ti_import_field_names)\n            }\n\n            for k, c in column_dict.items():\n                c.pages.append(col_map[k])\n\n        if columns is None:\n            columns = [c[\"name\"] for c in task_columns]\n\n        table_dict = {\n            a[\"name\"]: column_dict[b]\n            for a, b in zip(task_columns, columns)\n        }\n\n        pbar.update(pbar.total - pbar.n)\n\n        table = T(columns=table_dict)\n\n    return table\n</code></pre>"},{"location":"reference/nimlite/#tablite.nimlite.wrap","title":"<code>tablite.nimlite.wrap(str_: str) -&gt; str</code>","text":"Source code in <code>tablite/nimlite.py</code> <pre><code>def wrap(str_: str) -&gt; str:\n    return '\"' + str_.replace('\"', '\\\\\"').replace(\"'\", \"\\\\'\").replace(\"\\n\", \"\\\\n\").replace(\"\\t\", \"\\\\t\") + '\"'\n</code></pre>"},{"location":"reference/nimlite/#tablite.nimlite.column_select","title":"<code>tablite.nimlite.column_select(table: K, cols: list[ColumnSelectorDict], tqdm=_tqdm, TaskManager=TaskManager) -&gt; Tuple[K, K]</code>","text":"Source code in <code>tablite/nimlite.py</code> <pre><code>def column_select(table: K, cols: list[ColumnSelectorDict], tqdm=_tqdm, TaskManager=TaskManager) -&gt; Tuple[K, K]:\n    with tqdm(total=100, desc=\"column select\", bar_format='{desc}: {percentage:.1f}%|{bar}{r_bar}') as pbar:\n        T = type(table)\n        dir_pid = Config.workdir / Config.pid\n\n        col_infos = nl.collect_column_select_info(table, cols, str(dir_pid), pbar)\n\n        columns = col_infos[\"columns\"]\n        page_count = col_infos[\"page_count\"]\n        is_correct_type = col_infos[\"is_correct_type\"]\n        desired_column_map = col_infos[\"desired_column_map\"]\n        original_pages_map = col_infos[\"original_pages_map\"]\n        passed_column_data = col_infos[\"passed_column_data\"]\n        failed_column_data = col_infos[\"failed_column_data\"]\n        res_cols_pass = col_infos[\"res_cols_pass\"]\n        res_cols_fail = col_infos[\"res_cols_fail\"]\n        column_names = col_infos[\"column_names\"]\n        reject_reason_name = col_infos[\"reject_reason_name\"]\n\n        if all(is_correct_type.values()):\n            tbl_pass_columns = {\n                desired_name: table[desired_info[0]]\n                for desired_name, desired_info in desired_column_map.items()\n            }\n\n            tbl_fail_columns = {\n                desired_name: []\n                for desired_name in failed_column_data\n            }\n\n            tbl_pass = T(columns=tbl_pass_columns)\n            tbl_fail = T(columns=tbl_fail_columns)\n\n            return (tbl_pass, tbl_fail)\n\n        task_list_inp = (\n            _collect_cs_info(i, columns, res_cols_pass, res_cols_fail, original_pages_map)\n            for i in range(page_count)\n        )\n\n        page_size = Config.PAGE_SIZE\n\n        tasks = (\n            Task(\n                nl.do_slice_convert, str(dir_pid), page_size, columns, reject_reason_name, res_pass, res_fail, desired_column_map, column_names, is_correct_type\n            )\n            for columns, res_pass, res_fail in task_list_inp\n        )\n\n        cpu_count = max(psutil.cpu_count(), 1)\n\n        if Config.MULTIPROCESSING_MODE == Config.FORCE:\n            is_mp = True\n        elif Config.MULTIPROCESSING_MODE == Config.FALSE:\n            is_mp = False\n        elif Config.MULTIPROCESSING_MODE == Config.AUTO:\n            is_multithreaded = cpu_count &gt; 1\n            is_multipage = page_count &gt; 1\n\n            is_mp = is_multithreaded and is_multipage\n\n        tbl_pass = T({k: [] for k in passed_column_data})\n        tbl_fail = T({k: [] for k in failed_column_data})\n\n        converted = []\n        step_size = 45 / max(page_count, 1)\n\n        if is_mp:\n            class WrapUpdate:\n                def update(self, n):\n                    pbar.update(n * step_size)\n\n            with TaskManager(min(cpu_count, page_count), error_mode=\"exception\") as tm:\n                res = tm.execute(list(tasks), pbar=WrapUpdate())\n\n                converted.extend(res)\n        else:\n            for task in tasks:\n                res = task.f(*task.args, **task.kwargs)\n\n                converted.append(res)\n                pbar.update(step_size)\n\n        def extend_table(table, columns):\n            for (col_name, pg) in columns:\n                table[col_name].pages.append(pg)\n\n        for pg_pass, pg_fail in converted:\n            extend_table(tbl_pass, pg_pass)\n            extend_table(tbl_fail, pg_fail)\n\n        pbar.update(pbar.total - pbar.n)\n\n        return tbl_pass, tbl_fail\n</code></pre>"},{"location":"reference/nimlite/#tablite.nimlite.read_page","title":"<code>tablite.nimlite.read_page(path: Union[str, Path]) -&gt; np.ndarray</code>","text":"Source code in <code>tablite/nimlite.py</code> <pre><code>def read_page(path: Union[str, Path]) -&gt; np.ndarray:\n    return nl.read_page(str(path))\n</code></pre>"},{"location":"reference/nimlite/#tablite.nimlite.repaginate","title":"<code>tablite.nimlite.repaginate(column: Column)</code>","text":"Source code in <code>tablite/nimlite.py</code> <pre><code>def repaginate(column: Column):\n    nl.repaginate(column)\n</code></pre>"},{"location":"reference/nimlite/#tablite.nimlite.nearest_neighbour","title":"<code>tablite.nimlite.nearest_neighbour(T: BaseTable, sources: Union[list[str], None], missing: Union[list, None], targets: Union[list[str], None], tqdm=_tqdm)</code>","text":"Source code in <code>tablite/nimlite.py</code> <pre><code>def nearest_neighbour(T: BaseTable, sources: Union[list[str], None], missing: Union[list, None], targets: Union[list[str], None], tqdm=_tqdm):\n    return nl.nearest_neighbour(T, sources, list(missing), targets, tqdm)\n</code></pre>"},{"location":"reference/nimlite/#tablite.nimlite.groupby","title":"<code>tablite.nimlite.groupby(T, keys, functions, tqdm=_tqdm)</code>","text":"Source code in <code>tablite/nimlite.py</code> <pre><code>def groupby(T, keys, functions, tqdm=_tqdm):\n    return nl.groupby(T, keys, functions, tqdm)\n</code></pre>"},{"location":"reference/nimlite/#tablite.nimlite.filter","title":"<code>tablite.nimlite.filter(table: BaseTable, expressions: list[FilterDict], type: FilterType, tqdm=_tqdm)</code>","text":"Source code in <code>tablite/nimlite.py</code> <pre><code>def filter(table: BaseTable, expressions: list[FilterDict], type: FilterType, tqdm = _tqdm):\n    return nl.filter(table, expressions, type, tqdm)\n</code></pre>"},{"location":"reference/pivots/","title":"Pivots","text":""},{"location":"reference/pivots/#tablite.pivots","title":"<code>tablite.pivots</code>","text":""},{"location":"reference/pivots/#tablite.pivots-classes","title":"Classes","text":""},{"location":"reference/pivots/#tablite.pivots-functions","title":"Functions","text":""},{"location":"reference/pivots/#tablite.pivots.acc2Name","title":"<code>tablite.pivots.acc2Name(acc: str) -&gt; str</code>","text":"Source code in <code>tablite/pivots.py</code> <pre><code>def acc2Name(acc: str) -&gt; str:\n    arr = [\"max\", \"min\", \"sum\", \"product\", \"first\", \"last\", \"count\", \"median\", \"mode\"]\n    if acc in arr:\n        return acc.capitalize()\n    elif acc == \"count_unique\":\n        return \"CountUnique\"\n    elif acc == \"avg\":\n        return \"Average\"\n    elif acc == \"stdev\":\n        return \"StandardDeviation\"\n    else:\n        raise ValueError(f\"unknown accumulator - {acc}\")\n</code></pre>"},{"location":"reference/pivots/#tablite.pivots.pivot","title":"<code>tablite.pivots.pivot(T, rows, columns, functions, values_as_rows=True, tqdm=_tqdm, pbar=None)</code>","text":"<p>param: rows: column names to keep as rows param: columns: column names to keep as columns param: functions: aggregation functions from the Groupby class as</p> <p>example:</p> <pre><code>&gt;&gt;&gt; t.show()\n+=====+=====+=====+\n|  A  |  B  |  C  |\n| int | int | int |\n+-----+-----+-----+\n|    1|    1|    6|\n|    1|    2|    5|\n|    2|    3|    4|\n|    2|    4|    3|\n|    3|    5|    2|\n|    3|    6|    1|\n|    1|    1|    6|\n|    1|    2|    5|\n|    2|    3|    4|\n|    2|    4|    3|\n|    3|    5|    2|\n|    3|    6|    1|\n+=====+=====+=====+\n\n&gt;&gt;&gt; t2 = t.pivot(rows=['C'], columns=['A'], functions=[('B', gb.sum)])\n&gt;&gt;&gt; t2.show()\n+===+===+========+=====+=====+=====+\n| # | C |function|(A=1)|(A=2)|(A=3)|\n|row|int|  str   |mixed|mixed|mixed|\n+---+---+--------+-----+-----+-----+\n|0  |  6|Sum(B)  |    2|None |None |\n|1  |  5|Sum(B)  |    4|None |None |\n|2  |  4|Sum(B)  |None |    6|None |\n|3  |  3|Sum(B)  |None |    8|None |\n|4  |  2|Sum(B)  |None |None |   10|\n|5  |  1|Sum(B)  |None |None |   12|\n+===+===+========+=====+=====+=====+\n</code></pre> Source code in <code>tablite/pivots.py</code> <pre><code>def pivot(T, rows, columns, functions, values_as_rows=True, tqdm=_tqdm, pbar=None):\n    \"\"\"\n    param: rows: column names to keep as rows\n    param: columns: column names to keep as columns\n    param: functions: aggregation functions from the Groupby class as\n\n    example:\n    ```\n    &gt;&gt;&gt; t.show()\n    +=====+=====+=====+\n    |  A  |  B  |  C  |\n    | int | int | int |\n    +-----+-----+-----+\n    |    1|    1|    6|\n    |    1|    2|    5|\n    |    2|    3|    4|\n    |    2|    4|    3|\n    |    3|    5|    2|\n    |    3|    6|    1|\n    |    1|    1|    6|\n    |    1|    2|    5|\n    |    2|    3|    4|\n    |    2|    4|    3|\n    |    3|    5|    2|\n    |    3|    6|    1|\n    +=====+=====+=====+\n\n    &gt;&gt;&gt; t2 = t.pivot(rows=['C'], columns=['A'], functions=[('B', gb.sum)])\n    &gt;&gt;&gt; t2.show()\n    +===+===+========+=====+=====+=====+\n    | # | C |function|(A=1)|(A=2)|(A=3)|\n    |row|int|  str   |mixed|mixed|mixed|\n    +---+---+--------+-----+-----+-----+\n    |0  |  6|Sum(B)  |    2|None |None |\n    |1  |  5|Sum(B)  |    4|None |None |\n    |2  |  4|Sum(B)  |None |    6|None |\n    |3  |  3|Sum(B)  |None |    8|None |\n    |4  |  2|Sum(B)  |None |None |   10|\n    |5  |  1|Sum(B)  |None |None |   12|\n    +===+===+========+=====+=====+=====+\n    ```\n\n    \"\"\"\n    sub_cls_check(T, BaseTable)\n\n    if isinstance(rows, str):\n        rows = [rows]\n    if not all(isinstance(i, str) for i in rows):\n        raise TypeError(f\"Expected rows as a list of column names, not {[i for i in rows if not isinstance(i,str)]}\")\n\n    if isinstance(columns, str):\n        columns = [columns]\n    if not all(isinstance(i, str) for i in columns):\n        raise TypeError(\n            f\"Expected columns as a list of column names, not {[i for i in columns if not isinstance(i, str)]}\"\n        )\n\n    if not isinstance(values_as_rows, bool):\n        raise TypeError(f\"expected sum_on_rows as boolean, not {type(values_as_rows)}\")\n\n    keys = rows + columns\n    assert isinstance(keys, list)\n\n    extra_steps = 2\n\n    if pbar is None:\n        total = extra_steps\n\n        if len(functions) == 0:\n            total = total + len(keys)\n        else:\n            total = total + len(T)\n\n        pbar = tqdm(total=total, desc=\"pivot\")\n\n    grpby = groupby(T, keys, functions, tqdm=tqdm)\n    Constr = type(T)\n\n    if len(grpby) == 0:  # return empty table. This must be a test?\n        pbar.update(extra_steps)\n        return Constr()\n\n    # split keys to determine grid dimensions\n    row_key_index = {}\n    col_key_index = {}\n\n    r = len(rows)\n    c = len(columns)\n    g = len(functions)\n\n    records = defaultdict(dict)\n\n    for row in grpby.rows:\n        row_key = tuple(row[:r])\n        col_key = tuple(row[r : r + c])\n        func_key = tuple(row[r + c :])\n\n        if row_key not in row_key_index:\n            row_key_index[row_key] = len(row_key_index)  # Y\n\n        if col_key not in col_key_index:\n            col_key_index[col_key] = len(col_key_index)  # X\n\n        rix = row_key_index[row_key]\n        cix = col_key_index[col_key]\n        if cix in records:\n            if rix in records[cix]:\n                raise ValueError(\"this should be empty.\")\n        records[cix][rix] = func_key\n\n    pbar.update(1)\n    result = type(T)()\n\n    if values_as_rows:  # ---&gt; leads to more rows.\n        # first create all columns left to right\n\n        n = r + 1  # rows keys + 1 col for function values.\n        cols = [[] for _ in range(n)]\n        for row, ix in row_key_index.items():\n            for col_name, f in functions:\n                cols[-1].append(f\"{acc2Name(f)}({col_name})\")\n                for col_ix, v in enumerate(row):\n                    cols[col_ix].append(v)\n\n        for col_name, values in zip(rows + [\"function\"], cols):\n            col_name = unique_name(col_name, result.columns)\n            result[col_name] = values\n        col_length = len(cols[0])\n        cols.clear()\n\n        # then populate the sparse matrix.\n        for col_key, c in col_key_index.items():\n            col_name = \"(\" + \",\".join([f\"{col_name}={value}\" for col_name, value in zip(columns, col_key)]) + \")\"\n            col_name = unique_name(col_name, result.columns)\n            L = [None for _ in range(col_length)]\n            for r, funcs in records[c].items():\n                for ix, f in enumerate(funcs):\n                    L[g * r + ix] = f\n            result[col_name] = L\n\n    else:  # ---&gt; leads to more columns.\n        n = r\n        cols = [[] for _ in range(n)]\n        for row in row_key_index:\n            for col_ix, v in enumerate(row):\n                cols[col_ix].append(v)  # write key columns.\n\n        for col_name, values in zip(rows, cols):\n            result[col_name] = values\n\n        col_length = len(row_key_index)\n\n        # now populate the sparse matrix.\n        for col_key, c in col_key_index.items():  # select column.\n            cols, names = [], []\n\n            for f, v in zip(functions, func_key):\n                agg_col, func = f\n                terms = \",\".join([agg_col] + [f\"{col_name}={value}\" for col_name, value in zip(columns, col_key)])\n                col_name = f\"{acc2Name(func)}({terms})\"\n                col_name = unique_name(col_name, result.columns)\n                names.append(col_name)\n                cols.append([None for _ in range(col_length)])\n            for r, funcs in records[c].items():\n                for ix, f in enumerate(funcs):\n                    cols[ix][r] = f\n            for name, col in zip(names, cols):\n                result[name] = col\n\n    pbar.update(1)\n\n    return result\n</code></pre>"},{"location":"reference/pivots/#tablite.pivots.transpose","title":"<code>tablite.pivots.transpose(T, tqdm=_tqdm)</code>","text":"<p>performs a CCW matrix rotation of the table.</p> Source code in <code>tablite/pivots.py</code> <pre><code>def transpose(T, tqdm=_tqdm):\n    \"\"\"performs a CCW matrix rotation of the table.\"\"\"\n    sub_cls_check(T, BaseTable)\n\n    if len(T.columns) == 0:\n        return type(T)()\n\n    assert isinstance(T, BaseTable)\n    new = type(T)()\n    L = list(T.columns)\n    new[L[0]] = L[1:]\n    for row in tqdm(T.rows, desc=\"table transpose\", total=len(T)):\n        new[row[0]] = row[1:]\n    return new\n</code></pre>"},{"location":"reference/pivots/#tablite.pivots.pivot_transpose","title":"<code>tablite.pivots.pivot_transpose(T, columns, keep=None, column_name='transpose', value_name='value', tqdm=_tqdm)</code>","text":"<p>Transpose a selection of columns to rows.</p> PARAMETER  DESCRIPTION <code>columns</code> <p>column names to transpose</p> <p> TYPE: <code>list of column names</code> </p> <code>keep</code> <p>column names to keep (repeat)</p> <p> TYPE: <code>list of column names</code> DEFAULT: <code>None</code> </p> RETURNS DESCRIPTION <code>Table</code> <p>with columns transposed to rows</p> Example <p>transpose columns 1,2 and 3 and transpose the remaining columns, except <code>sum</code>.</p> <p>Input:</p> <pre><code>| col1 | col2 | col3 | sun | mon | tue | ... | sat | sum  |\n|------|------|------|-----|-----|-----|-----|-----|------|\n| 1234 | 2345 | 3456 | 456 | 567 |     | ... |     | 1023 |\n| 1244 | 2445 | 4456 |     |   7 |     | ... |     |    7 |\n| ...  |      |      |     |     |     |     |     |      |\n\n&gt;&gt;&gt; t.transpose(keep=[col1, col2, col3], transpose=[sun,mon,tue,wed,thu,fri,sat])`\n\nOutput:\n|col1| col2| col3| transpose| value|\n|----|-----|-----|----------|------|\n|1234| 2345| 3456| sun      |   456|\n|1234| 2345| 3456| mon      |   567|\n|1244| 2445| 4456| mon      |     7|\n</code></pre> Source code in <code>tablite/pivots.py</code> <pre><code>def pivot_transpose(T, columns, keep=None, column_name=\"transpose\", value_name=\"value\", tqdm=_tqdm):\n    \"\"\"Transpose a selection of columns to rows.\n\n    Args:\n        columns (list of column names): column names to transpose\n        keep (list of column names): column names to keep (repeat)\n\n    Returns:\n        Table: with columns transposed to rows\n\n    Example:\n        transpose columns 1,2 and 3 and transpose the remaining columns, except `sum`.\n\n    Input:\n    ```\n    | col1 | col2 | col3 | sun | mon | tue | ... | sat | sum  |\n    |------|------|------|-----|-----|-----|-----|-----|------|\n    | 1234 | 2345 | 3456 | 456 | 567 |     | ... |     | 1023 |\n    | 1244 | 2445 | 4456 |     |   7 |     | ... |     |    7 |\n    | ...  |      |      |     |     |     |     |     |      |\n\n    &gt;&gt;&gt; t.transpose(keep=[col1, col2, col3], transpose=[sun,mon,tue,wed,thu,fri,sat])`\n\n    Output:\n    |col1| col2| col3| transpose| value|\n    |----|-----|-----|----------|------|\n    |1234| 2345| 3456| sun      |   456|\n    |1234| 2345| 3456| mon      |   567|\n    |1244| 2445| 4456| mon      |     7|\n    ```\n\n    \"\"\"\n    sub_cls_check(T, BaseTable)\n\n    if not isinstance(columns, list):\n        raise TypeError\n\n    for i in columns:\n        if not isinstance(i, str):\n            raise TypeError\n        if i not in T.columns:\n            raise ValueError\n        if columns.count(i)&gt;1:\n            raise ValueError(f\"Column {i} appears more than once\")\n\n    if keep is None:\n        keep = []\n    for i in keep:\n        if not isinstance(i, str):\n            raise TypeError\n        if i not in T.columns:\n            raise ValueError\n\n    if column_name in keep + columns:\n        column_name = unique_name(column_name, set_of_names=keep + columns)\n    if value_name in keep + columns + [column_name]:\n        value_name = unique_name(value_name, set_of_names=keep + columns)\n\n    new = type(T)()\n    new.add_columns(*keep + [column_name, value_name])\n    news = {name: [] for name in new.columns}\n\n    n = len(keep)\n\n    with tqdm(total=len(T), desc=\"transpose\", disable=Config.TQDM_DISABLE) as pbar:\n        it = T[keep + columns].rows if len(keep + columns) &gt; 1 else ((v, ) for v in T[keep + columns])\n\n        for ix, row in enumerate(it, start=1):\n            keeps = row[:n]\n            transposes = row[n:]\n\n            for name, value in zip(keep, keeps):\n                news[name].extend([value] * len(transposes))\n            for name, value in zip(columns, transposes):\n                news[column_name].append(name)\n                news[value_name].append(value)\n\n            if ix % Config.SINGLE_PROCESSING_LIMIT == 0:\n                for name, values in news.items():\n                    new[name].extend(values)\n                    values.clear()\n\n            pbar.update(1)\n\n    for name, values in news.items():\n        new[name].extend(np.array(values))\n        values.clear()\n    return new\n</code></pre>"},{"location":"reference/redux/","title":"Redux","text":""},{"location":"reference/redux/#tablite.redux","title":"<code>tablite.redux</code>","text":""},{"location":"reference/redux/#tablite.redux-attributes","title":"Attributes","text":""},{"location":"reference/redux/#tablite.redux-classes","title":"Classes","text":""},{"location":"reference/redux/#tablite.redux-functions","title":"Functions","text":""},{"location":"reference/redux/#tablite.redux.filter_all","title":"<code>tablite.redux.filter_all(T, **kwargs)</code>","text":"<p>returns Table for rows where ALL kwargs match :param kwargs: dictionary with headers and values / boolean callable</p> <p>Examples:</p> <pre><code>t = Table()\nt['a'] = [1,2,3,4]\nt['b'] = [10,20,30,40]\n\ndef f(x):\n    return x == 4\ndef g(x):\n    return x &lt; 20\n\nt2 = t.any( **{\"a\":f, \"b\":g})\nassert [r for r in t2.rows] == [[1, 10], [4, 40]]\n\nt2 = t.any(a=f,b=g)\nassert [r for r in t2.rows] == [[1, 10], [4, 40]]\n\ndef h(x):\n    return x&gt;=2\n\ndef i(x):\n    return x&lt;=30\n\nt2 = t.all(a=h,b=i)\nassert [r for r in t2.rows] == [[2,20], [3, 30]]\n</code></pre> Source code in <code>tablite/redux.py</code> <pre><code>def filter_all(T, **kwargs):\n    \"\"\"\n    returns Table for rows where ALL kwargs match\n    :param kwargs: dictionary with headers and values / boolean callable\n\n    Examples:\n\n        t = Table()\n        t['a'] = [1,2,3,4]\n        t['b'] = [10,20,30,40]\n\n        def f(x):\n            return x == 4\n        def g(x):\n            return x &lt; 20\n\n        t2 = t.any( **{\"a\":f, \"b\":g})\n        assert [r for r in t2.rows] == [[1, 10], [4, 40]]\n\n        t2 = t.any(a=f,b=g)\n        assert [r for r in t2.rows] == [[1, 10], [4, 40]]\n\n        def h(x):\n            return x&gt;=2\n\n        def i(x):\n            return x&lt;=30\n\n        t2 = t.all(a=h,b=i)\n        assert [r for r in t2.rows] == [[2,20], [3, 30]]\n\n\n    \"\"\"\n    sub_cls_check(T, BaseTable)\n\n    if not isinstance(kwargs, dict):\n        raise TypeError(\"did you forget to add the ** in front of your dict?\")\n    if not all([k in T.columns for k in kwargs]):\n        raise ValueError(f\"Unknown column(s): {[k for k in kwargs if k not in T.columns]}\")\n\n    mask = np.full((len(T),), True)\n    for k, v in kwargs.items():\n        col = T[k]\n        for start, end, page in col.iter_by_page():\n            data = page.get()\n            if callable(v):\n                vf = np.frompyfunc(v, 1, 1)\n                mask[start:end] = mask[start:end] &amp; np.apply_along_axis(vf, 0, data)\n            else:\n                mask[start:end] = mask[start:end] &amp; (data == v)\n\n    return _compress_one(T, mask)\n</code></pre>"},{"location":"reference/redux/#tablite.redux.drop","title":"<code>tablite.redux.drop(T, *args)</code>","text":"<p>drops all rows that contain args</p> PARAMETER  DESCRIPTION <code>T</code> <p> TYPE: <code>Table</code> </p> Source code in <code>tablite/redux.py</code> <pre><code>def drop(T, *args):\n    \"\"\"drops all rows that contain args\n\n    Args:\n        T (Table):\n    \"\"\"\n    sub_cls_check(T, BaseTable)\n    mask = np.full((len(T),), False)\n    for name in T.columns:\n        col = T[name]\n        for start, end, page in col.iter_by_page():\n            data = page.get()\n            for arg in args:\n                mask[start:end] = mask[start:end] | (data == arg)\n\n    mask = np.invert(mask)\n    return _compress_one(T, mask)\n</code></pre>"},{"location":"reference/redux/#tablite.redux.filter_any","title":"<code>tablite.redux.filter_any(T, **kwargs)</code>","text":"<p>returns Table for rows where ANY kwargs match :param kwargs: dictionary with headers and values / boolean callable</p> Source code in <code>tablite/redux.py</code> <pre><code>def filter_any(T, **kwargs):\n    \"\"\"\n    returns Table for rows where ANY kwargs match\n    :param kwargs: dictionary with headers and values / boolean callable\n    \"\"\"\n    sub_cls_check(T, BaseTable)\n    if not isinstance(kwargs, dict):\n        raise TypeError(\"did you forget to add the ** in front of your dict?\")\n\n    mask = np.full((len(T),), False)\n    for k, v in kwargs.items():\n        col = T[k]\n        for start, end, page in col.iter_by_page():\n            data = page.get()\n            if callable(v):\n                vf = np.frompyfunc(v, 1, 1)\n                mask[start:end] = mask[start:end] | np.apply_along_axis(vf, 0, data)\n            else:\n                mask[start:end] = mask[start:end] | (v == data)\n\n    return _compress_one(T, mask)\n</code></pre>"},{"location":"reference/redux/#tablite.redux.filter","title":"<code>tablite.redux.filter(T, expressions, filter_type='all', tqdm=_tqdm)</code>","text":"<p>filters table</p> PARAMETER  DESCRIPTION <code>T</code> <p>Table.</p> <p> TYPE: <code>Table subclass</code> </p> <code>expressions</code> <p>str:     filters based on an expression, such as:     \"all((A==B, C!=4, 200&lt;D))\"     which is interpreted using python's compiler to:</p> <pre><code>def _f(A,B,C,D):\n    return all((A==B, C!=4, 200&lt;D))\n</code></pre> <p>list of dicts: (example):</p> <p>L = [     {'column1':'A', 'criteria': \"==\", 'column2': 'B'},     {'column1':'C', 'criteria': \"!=\", \"value2\": '4'},     {'value1': 200, 'criteria': \"&lt;\", column2: 'D' } ]</p> <p> TYPE: <code>list or str</code> </p> <code>accepted</code> <p>'column1', 'column2', 'criteria', 'value1', 'value2'</p> <p> TYPE: <code>dictionary keys</code> </p> <code>filter_type</code> <p>Ignored if expressions is str. 'all' or 'any'. Defaults to \"all\".</p> <p> TYPE: <code>str</code> DEFAULT: <code>'all'</code> </p> <code>tqdm</code> <p>progressbar. Defaults to _tqdm.</p> <p> TYPE: <code>tqdm</code> DEFAULT: <code>tqdm</code> </p> RETURNS DESCRIPTION <code>2xTables</code> <p>trues, falses</p> Source code in <code>tablite/redux.py</code> <pre><code>def filter(T, expressions, filter_type=\"all\", tqdm=_tqdm):\n    \"\"\"filters table\n\n\n    Args:\n        T (Table subclass): Table.\n        expressions (list or str):\n            str:\n                filters based on an expression, such as:\n                \"all((A==B, C!=4, 200&lt;D))\"\n                which is interpreted using python's compiler to:\n\n                def _f(A,B,C,D):\n                    return all((A==B, C!=4, 200&lt;D))\n\n            list of dicts: (example):\n\n            L = [\n                {'column1':'A', 'criteria': \"==\", 'column2': 'B'},\n                {'column1':'C', 'criteria': \"!=\", \"value2\": '4'},\n                {'value1': 200, 'criteria': \"&lt;\", column2: 'D' }\n            ]\n\n        accepted dictionary keys: 'column1', 'column2', 'criteria', 'value1', 'value2'\n\n        filter_type (str, optional): Ignored if expressions is str.\n            'all' or 'any'. Defaults to \"all\".\n        tqdm (tqdm, optional): progressbar. Defaults to _tqdm.\n\n    Returns:\n        2xTables: trues, falses\n    \"\"\"\n    # determine method\n    sub_cls_check(T, BaseTable)\n    if len(T) == 0:\n        return T.copy(), T.copy()\n\n    if isinstance(expressions, str):\n        with tqdm(desc=\"filter\", total=20) as pbar:\n            # TODO: make parser for expressions and use the nim implement\n            mask = _filter_using_expression(T, expressions)\n            pbar.update(10)\n            res = _compress_both(T, mask, pbar=pbar)\n            pbar.update(pbar.total - pbar.n)\n    elif isinstance(expressions, list):\n        return _filter_using_list_of_dicts(T, expressions, filter_type, tqdm)\n    else:\n        raise TypeError\n        # create new tables\n\n    return res\n</code></pre>"},{"location":"reference/reindex/","title":"Reindex","text":""},{"location":"reference/reindex/#tablite.reindex","title":"<code>tablite.reindex</code>","text":""},{"location":"reference/reindex/#tablite.reindex-classes","title":"Classes","text":""},{"location":"reference/reindex/#tablite.reindex-functions","title":"Functions","text":""},{"location":"reference/reindex/#tablite.reindex.reindex","title":"<code>tablite.reindex.reindex(T, index, names=None, tqdm=_tqdm, pbar=None)</code>","text":"<p>Constant Memory helper for reindexing pages.</p> <p>Memory usage is set by datatype and Config.PAGE_SIZE</p> PARAMETER  DESCRIPTION <code>T</code> <p>subclass of Table</p> <p> TYPE: <code>Table</code> </p> <code>index</code> <p>int64.</p> <p> TYPE: <code>array</code> </p> <code>names</code> <p>list of names from T to reindex.</p> <p> TYPE: <code>(list, str)</code> DEFAULT: <code>None</code> </p> <code>tqdm</code> <p>Defaults to _tqdm.</p> <p> TYPE: <code>tqdm</code> DEFAULT: <code>tqdm</code> </p> <code>pbar</code> <p>Defaults to None.</p> <p> TYPE: <code>pbar</code> DEFAULT: <code>None</code> </p> RETURNS DESCRIPTION <code>_type_</code> <p>description</p> Source code in <code>tablite/reindex.py</code> <pre><code>def reindex(T, index, names=None, tqdm=_tqdm, pbar=None):\n    \"\"\"Constant Memory helper for reindexing pages.\n\n    Memory usage is set by datatype and Config.PAGE_SIZE\n\n    Args:\n        T (Table): subclass of Table\n        index (np.array): int64.\n        names (list, str): list of names from T to reindex.\n        tqdm (tqdm, optional): Defaults to _tqdm.\n        pbar (pbar, optional): Defaults to None.\n\n    Returns:\n        _type_: _description_\n    \"\"\"\n    if names is None:\n        names = list(T.columns.keys())\n\n    if pbar is None:\n        total = len(names)\n        pbar = tqdm(total=total, desc=\"join\", disable=Config.TQDM_DISABLE)\n\n    sub_cls_check(T, BaseTable)\n    cls = type(T)\n    result = cls()\n    for name in names:\n        result.add_column(name)\n        col = result[name]\n\n        for start, end in Config.page_steps(len(index)):\n            indices = index[start:end]\n            values = T[name].get_by_indices(indices)\n            # in these values, the index of -1 will be wrong.\n            # so if there is any -1 in the indices, they will\n            # have to be replaced with Nones\n            mask = indices == -1\n            if np.any(mask):\n                nones = np.full(index.shape, fill_value=None)\n                values = np.where(mask, nones, values)\n            col.extend(values)\n        pbar.update(1)\n\n    return result\n</code></pre>"},{"location":"reference/sort_utils/","title":"Sort utils","text":""},{"location":"reference/sort_utils/#tablite.sort_utils","title":"<code>tablite.sort_utils</code>","text":""},{"location":"reference/sort_utils/#tablite.sort_utils-attributes","title":"Attributes","text":""},{"location":"reference/sort_utils/#tablite.sort_utils.uca_collator","title":"<code>tablite.sort_utils.uca_collator = Collator()</code>  <code>module-attribute</code>","text":""},{"location":"reference/sort_utils/#tablite.sort_utils.modes","title":"<code>tablite.sort_utils.modes = {'alphanumeric': text_sort, 'unix': unix_sort, 'excel': excel_sort}</code>  <code>module-attribute</code>","text":""},{"location":"reference/sort_utils/#tablite.sort_utils-classes","title":"Classes","text":""},{"location":"reference/sort_utils/#tablite.sort_utils.HashDict","title":"<code>tablite.sort_utils.HashDict</code>","text":"<p>             Bases: <code>dict</code></p> <p>This class is just a nicity syntatic sugar for debugging. Function identically to regular dictionary, just uses tupled key.</p>"},{"location":"reference/sort_utils/#tablite.sort_utils.HashDict-functions","title":"Functions","text":""},{"location":"reference/sort_utils/#tablite.sort_utils.HashDict.items","title":"<code>tablite.sort_utils.HashDict.items()</code>","text":"Source code in <code>tablite/sort_utils.py</code> <pre><code>def items(self):\n    return [(k, v) for (_, k), v in super().items()]\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils.HashDict.keys","title":"<code>tablite.sort_utils.HashDict.keys()</code>","text":"Source code in <code>tablite/sort_utils.py</code> <pre><code>def keys(self):\n    return [k for (_, k) in super().keys()]\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils.HashDict.__iter__","title":"<code>tablite.sort_utils.HashDict.__iter__() -&gt; Iterator</code>","text":"Source code in <code>tablite/sort_utils.py</code> <pre><code>def __iter__(self) -&gt; Iterator:\n    return (k for (_, k) in super().keys())\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils.HashDict.__getitem__","title":"<code>tablite.sort_utils.HashDict.__getitem__(key)</code>","text":"Source code in <code>tablite/sort_utils.py</code> <pre><code>def __getitem__(self, key):\n    return super().__getitem__(self._get_hash(key))\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils.HashDict.__setitem__","title":"<code>tablite.sort_utils.HashDict.__setitem__(key, value)</code>","text":"Source code in <code>tablite/sort_utils.py</code> <pre><code>def __setitem__(self, key, value):\n    return super().__setitem__(self._get_hash(key), value)\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils.HashDict.__contains__","title":"<code>tablite.sort_utils.HashDict.__contains__(key) -&gt; bool</code>","text":"Source code in <code>tablite/sort_utils.py</code> <pre><code>def __contains__(self, key) -&gt; bool:\n    return super().__contains__(self._get_hash(key))\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils.HashDict.__delitem__","title":"<code>tablite.sort_utils.HashDict.__delitem__(key)</code>","text":"Source code in <code>tablite/sort_utils.py</code> <pre><code>def __delitem__(self, key):\n    return super().__delitem__(self._get_hash(key))\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils.HashDict.__repr__","title":"<code>tablite.sort_utils.HashDict.__repr__() -&gt; str</code>","text":"Source code in <code>tablite/sort_utils.py</code> <pre><code>def __repr__(self) -&gt; str:\n    return '{' + \", \".join([f\"{k}: {v}\" for k, v in self.items()]) + '}'\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils.HashDict.__str__","title":"<code>tablite.sort_utils.HashDict.__str__() -&gt; str</code>","text":"Source code in <code>tablite/sort_utils.py</code> <pre><code>def __str__(self) -&gt; str:\n    return repr(self)\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils-functions","title":"Functions","text":""},{"location":"reference/sort_utils/#tablite.sort_utils.text_sort","title":"<code>tablite.sort_utils.text_sort(values, reverse=False)</code>","text":"<p>Sorts everything as text.</p> Source code in <code>tablite/sort_utils.py</code> <pre><code>def text_sort(values, reverse=False):\n    \"\"\"\n    Sorts everything as text.\n    \"\"\"\n    text = {str(i): i for i in values}\n    L = list(text.keys())\n    L.sort(key=uca_collator.sort_key, reverse=reverse)\n    d = {text[value]: ix for ix, value in enumerate(L)}\n    return d\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils.unix_sort","title":"<code>tablite.sort_utils.unix_sort(values, reverse=False)</code>","text":"<p>Unix sortation sorts by the following order:</p> <p>| rank | type      | value                                      | +------+-----------+--------------------------------------------+ |   0  | None      | floating point -infinite                   | |   1  | bool      | 0 as False, 1 as True                      | |   2  | int       | as numeric value                           | |   2  | float     | as numeric value                           | |   3  | time      | \u03c4 * seconds into the day / (24 * 60 * 60)  | |   4  | date      | as integer days since 1970/1/1             | |   5  | datetime  | as float using date (int) + time (decimal) | |   6  | timedelta | as float using date (int) + time (decimal) | |   7  | str       | using unicode                              | +------+-----------+--------------------------------------------+</p> <p>\u03c4 = 2 * \u03c0</p> Source code in <code>tablite/sort_utils.py</code> <pre><code>def unix_sort(values, reverse=False):\n    \"\"\"\n    Unix sortation sorts by the following order:\n\n    | rank | type      | value                                      |\n    +------+-----------+--------------------------------------------+\n    |   0  | None      | floating point -infinite                   |\n    |   1  | bool      | 0 as False, 1 as True                      |\n    |   2  | int       | as numeric value                           |\n    |   2  | float     | as numeric value                           |\n    |   3  | time      | \u03c4 * seconds into the day / (24 * 60 * 60)  |\n    |   4  | date      | as integer days since 1970/1/1             |\n    |   5  | datetime  | as float using date (int) + time (decimal) |\n    |   6  | timedelta | as float using date (int) + time (decimal) |\n    |   7  | str       | using unicode                              |\n    +------+-----------+--------------------------------------------+\n\n    \u03c4 = 2 * \u03c0\n\n    \"\"\"\n    text, non_text = [], []\n\n    # L = []\n    # text = [i for i in values if isinstance(i, str)]\n    # text.sort(key=uca_collator.sort_key, reverse=reverse)\n    # text_code = _unix_typecodes[str]\n    # L = [(text_code, ix, v) for ix, v in enumerate(text)]\n\n    for value in values:\n        if isinstance(value, str):\n            text.append(value)\n        else:\n            t = type(value)\n            TC = _unix_typecodes[t]\n            tf = _unix_value_function[t]\n            VC = tf(value)\n            non_text.append((TC, VC, value))\n    non_text.sort(reverse=reverse)\n\n    text.sort(key=uca_collator.sort_key, reverse=reverse)\n    text_code = _unix_typecodes[str]\n    text = [(text_code, ix, v) for ix, v in enumerate(text)]\n\n    d = HashDict()\n    L = non_text + text\n    for ix, (_, _, value) in enumerate(L):\n        d[value] = ix\n    return d\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils.excel_sort","title":"<code>tablite.sort_utils.excel_sort(values, reverse=False)</code>","text":"<p>Excel sortation sorts by the following order:</p> <p>| rank | type      | value                                      | +------+-----------+--------------------------------------------+ |   1  | int       | as numeric value                           | |   1  | float     | as numeric value                           | |   1  | time      | as seconds into the day / (24 * 60 * 60)   | |   1  | date      | as integer days since 1900/1/1             | |   1  | datetime  | as float using date (int) + time (decimal) | |  (1)*| timedelta | as float using date (int) + time (decimal) | |   2  | str       | using unicode                              | |   3  | bool      | 0 as False, 1 as True                      | |   4  | None      | floating point infinite.                   | +------+-----------+--------------------------------------------+</p> <ul> <li>Excel doesn't have timedelta.</li> </ul> Source code in <code>tablite/sort_utils.py</code> <pre><code>def excel_sort(values, reverse=False):\n    \"\"\"\n    Excel sortation sorts by the following order:\n\n    | rank | type      | value                                      |\n    +------+-----------+--------------------------------------------+\n    |   1  | int       | as numeric value                           |\n    |   1  | float     | as numeric value                           |\n    |   1  | time      | as seconds into the day / (24 * 60 * 60)   |\n    |   1  | date      | as integer days since 1900/1/1             |\n    |   1  | datetime  | as float using date (int) + time (decimal) |\n    |  (1)*| timedelta | as float using date (int) + time (decimal) |\n    |   2  | str       | using unicode                              |\n    |   3  | bool      | 0 as False, 1 as True                      |\n    |   4  | None      | floating point infinite.                   |\n    +------+-----------+--------------------------------------------+\n\n    * Excel doesn't have timedelta.\n    \"\"\"\n\n    def tup(TC, value):\n        return (TC, _excel_value_function[t](value), value)\n\n    text, numeric, booles, nones = [], [], [], []\n    for value in values:\n        t = type(value)\n        TC = _excel_typecodes[t]\n\n        if TC == 0:\n            numeric.append(tup(TC, value))\n        elif TC == 1:\n            text.append(value)  # text is processed later.\n        elif TC == 2:\n            booles.append(tup(TC, value))\n        elif TC == 3:\n            booles.append(tup(TC, value))\n        else:\n            raise TypeError(f\"no typecode for {value}\")\n\n    if text:\n        text.sort(key=uca_collator.sort_key, reverse=reverse)\n        text = [(2, ix, v) for ix, v in enumerate(text)]\n\n    numeric.sort(reverse=reverse)\n    booles.sort(reverse=reverse)\n    nones.sort(reverse=reverse)\n\n    if reverse:\n        L = nones + booles + text + numeric\n    else:\n        L = numeric + text + booles + nones\n    d = {value: ix for ix, (_, _, value) in enumerate(L)}\n    return d\n</code></pre>"},{"location":"reference/sort_utils/#tablite.sort_utils.rank","title":"<code>tablite.sort_utils.rank(values, reverse, mode)</code>","text":"<p>values: list of values to sort. reverse: bool mode: as 'text', as 'numeric' or as 'excel' return: dict: d[value] = rank</p> Source code in <code>tablite/sort_utils.py</code> <pre><code>def rank(values, reverse, mode):\n    \"\"\"\n    values: list of values to sort.\n    reverse: bool\n    mode: as 'text', as 'numeric' or as 'excel'\n    return: dict: d[value] = rank\n    \"\"\"\n    if mode not in modes:\n        raise ValueError(f\"{mode} not in list of modes: {list(modes)}\")\n    f = modes.get(mode)\n    return f(values, reverse)\n</code></pre>"},{"location":"reference/sortation/","title":"Sortation","text":""},{"location":"reference/sortation/#tablite.sortation","title":"<code>tablite.sortation</code>","text":""},{"location":"reference/sortation/#tablite.sortation-attributes","title":"Attributes","text":""},{"location":"reference/sortation/#tablite.sortation-classes","title":"Classes","text":""},{"location":"reference/sortation/#tablite.sortation-functions","title":"Functions","text":""},{"location":"reference/sortation/#tablite.sortation.sort_index","title":"<code>tablite.sortation.sort_index(T, mapping, sort_mode='excel', tqdm=_tqdm, pbar=None)</code>","text":"<p>helper for methods <code>sort</code> and <code>is_sorted</code></p> <p>param: sort_mode: str: \"alphanumeric\", \"unix\", or, \"excel\" (default) param: **kwargs: sort criteria. See Table.sort()</p> Source code in <code>tablite/sortation.py</code> <pre><code>def sort_index(T, mapping, sort_mode=\"excel\", tqdm=_tqdm, pbar=None):\n    \"\"\"\n    helper for methods `sort` and `is_sorted`\n\n    param: sort_mode: str: \"alphanumeric\", \"unix\", or, \"excel\" (default)\n    param: **kwargs: sort criteria. See Table.sort()\n    \"\"\"\n\n    sub_cls_check(T, BaseTable)\n\n    if not isinstance(mapping, dict) or not mapping:\n        raise TypeError(\"Expected mapping (dict)?\")\n\n    for k, v in mapping.items():\n        if k not in T.columns:\n            raise ValueError(f\"no column {k}\")\n        if not isinstance(v, bool):\n            raise ValueError(f\"{k} was mapped to {v} - a non-boolean\")\n\n    if sort_mode not in sort_modes:\n        raise ValueError(f\"{sort_mode} not in list of sort_modes: {list(sort_modes)}\")\n\n    rank = {i: tuple() for i in range(len(T))}  # create index and empty tuple for sortation.\n\n    _pbar = tqdm(total=len(mapping.items()), desc=\"creating sort index\") if pbar is None else pbar\n\n    for key, reverse in mapping.items():\n        col = T[key][:]\n        ranks = sort_rank(values=[numpy_to_python(v) for v in multitype_set(col)], reverse=reverse, mode=sort_mode)\n        assert isinstance(ranks, dict)\n        for ix, v in enumerate(col):\n            v2 = numpy_to_python(v)\n            rank[ix] += (ranks[v2],)  # add tuple for each sortation level.\n\n        _pbar.update(1)\n\n    del col\n    del ranks\n\n    new_order = [(r, i) for i, r in rank.items()]  # tuples are listed and sort...\n    del rank  # free memory.\n\n    new_order.sort()\n    sorted_index = [i for _, i in new_order]  # new index is extracted.\n    new_order.clear()\n    return np.array(sorted_index, dtype=np.int64)\n</code></pre>"},{"location":"reference/sortation/#tablite.sortation.reindex","title":"<code>tablite.sortation.reindex(T, index)</code>","text":"<p>index: list of integers that declare sort order.</p> <p>Examples:</p> <pre><code>Table:  ['a','b','c','d','e','f','g','h']\nindex:  [0,2,4,6]\nresult: ['b','d','f','h']\n\nTable:  ['a','b','c','d','e','f','g','h']\nindex:  [0,2,4,6,1,3,5,7]\nresult: ['a','c','e','g','b','d','f','h']\n</code></pre> Source code in <code>tablite/sortation.py</code> <pre><code>def reindex(T, index):\n    \"\"\"\n    index: list of integers that declare sort order.\n\n    Examples:\n\n        Table:  ['a','b','c','d','e','f','g','h']\n        index:  [0,2,4,6]\n        result: ['b','d','f','h']\n\n        Table:  ['a','b','c','d','e','f','g','h']\n        index:  [0,2,4,6,1,3,5,7]\n        result: ['a','c','e','g','b','d','f','h']\n\n    \"\"\"\n    sub_cls_check(T, BaseTable)\n    if isinstance(index, list):\n        index = np.array(index, dtype=int)\n    type_check(index, np.ndarray)\n    if max(index) &gt;= len(T):\n        raise IndexError(\"index out of range: max(index) &gt; len(self)\")\n    if min(index) &lt; -len(T):\n        raise IndexError(\"index out of range: min(index) &lt; -len(self)\")\n\n    fields = len(T) * len(T.columns)\n    m = select_processing_method(fields, _reindex, _mp_reindex)\n    return m(T, index)\n</code></pre>"},{"location":"reference/sortation/#tablite.sortation.sort","title":"<code>tablite.sortation.sort(T, mapping, sort_mode='excel', tqdm=_tqdm, pbar: _tqdm = None)</code>","text":"<p>Perform multi-pass sorting with precedence given order of column names. sort_mode: str: \"alphanumeric\", \"unix\", or, \"excel\" kwargs:     keys: columns,     values: 'reverse' as boolean.</p> <p>examples: Table.sort('A'=False) means sort by 'A' in ascending order. Table.sort('A'=True, 'B'=False) means sort 'A' in descending order, then (2nd priority) sort B in ascending order.</p> Source code in <code>tablite/sortation.py</code> <pre><code>def sort(T, mapping, sort_mode=\"excel\", tqdm=_tqdm, pbar: _tqdm = None):\n    \"\"\"Perform multi-pass sorting with precedence given order of column names.\n    sort_mode: str: \"alphanumeric\", \"unix\", or, \"excel\"\n    kwargs:\n        keys: columns,\n        values: 'reverse' as boolean.\n\n    examples:\n    Table.sort('A'=False) means sort by 'A' in ascending order.\n    Table.sort('A'=True, 'B'=False) means sort 'A' in descending order, then (2nd priority)\n    sort B in ascending order.\n    \"\"\"\n    sub_cls_check(T, BaseTable)\n\n    index = sort_index(T, mapping, sort_mode=sort_mode, tqdm=_tqdm, pbar=pbar)\n    m = select_processing_method(len(T) * len(T.columns), _sp_reindex, _mp_reindex)\n    return m(T, index, tqdm=tqdm, pbar=pbar)\n</code></pre>"},{"location":"reference/sortation/#tablite.sortation.is_sorted","title":"<code>tablite.sortation.is_sorted(T, mapping, sort_mode='excel')</code>","text":"<p>Performs multi-pass sorting check with precedence given order of column names.</p> PARAMETER  DESCRIPTION <code>mapping</code> <p>sort criteria. See Table.sort()</p> <p> </p> RETURNS DESCRIPTION <p>bool</p> Source code in <code>tablite/sortation.py</code> <pre><code>def is_sorted(T, mapping, sort_mode=\"excel\"):\n    \"\"\"Performs multi-pass sorting check with precedence given order of column names.\n\n    Args:\n        mapping: sort criteria. See Table.sort()\n        sort_mode = sort mode. See Table.sort()\n\n    Returns:\n        bool\n    \"\"\"\n    index = sort_index(T, mapping, sort_mode=sort_mode)\n    match = np.arange(len(T))\n    return np.all(index == match)\n</code></pre>"},{"location":"reference/tools/","title":"Tools","text":""},{"location":"reference/tools/#tablite.tools","title":"<code>tablite.tools</code>","text":""},{"location":"reference/tools/#tablite.tools-attributes","title":"Attributes","text":""},{"location":"reference/tools/#tablite.tools.guess","title":"<code>tablite.tools.guess = DataTypes.guess</code>  <code>module-attribute</code>","text":""},{"location":"reference/tools/#tablite.tools.xround","title":"<code>tablite.tools.xround = DataTypes.round</code>  <code>module-attribute</code>","text":""},{"location":"reference/tools/#tablite.tools-classes","title":"Classes","text":""},{"location":"reference/tools/#tablite.tools-functions","title":"Functions","text":""},{"location":"reference/tools/#tablite.tools.head","title":"<code>tablite.tools.head(path, linecount=5, delimiter=None)</code>","text":"<p>Gets the head of any supported file format.</p> Source code in <code>tablite/tools.py</code> <pre><code>def head(path, linecount=5, delimiter=None):\n    \"\"\"\n    Gets the head of any supported file format.\n    \"\"\"\n    return get_headers(path, linecount=linecount, delimiter=delimiter)\n</code></pre>"},{"location":"reference/utils/","title":"Utils","text":""},{"location":"reference/utils/#tablite.utils","title":"<code>tablite.utils</code>","text":""},{"location":"reference/utils/#tablite.utils-attributes","title":"Attributes","text":""},{"location":"reference/utils/#tablite.utils.letters","title":"<code>tablite.utils.letters = string.ascii_lowercase + string.digits</code>  <code>module-attribute</code>","text":""},{"location":"reference/utils/#tablite.utils.NoneType","title":"<code>tablite.utils.NoneType = type(None)</code>  <code>module-attribute</code>","text":""},{"location":"reference/utils/#tablite.utils.required_keys","title":"<code>tablite.utils.required_keys = {'min', 'max', 'mean', 'median', 'stdev', 'mode', 'distinct', 'iqr_low', 'iqr_high', 'iqr', 'sum', 'summary type', 'histogram'}</code>  <code>module-attribute</code>","text":""},{"location":"reference/utils/#tablite.utils.summary_methods","title":"<code>tablite.utils.summary_methods = {bool: _boolean_statistics_summary, int: _numeric_statistics_summary, float: _numeric_statistics_summary, str: _string_statistics_summary, date: _date_statistics_summary, datetime: _datetime_statistics_summary, time: _time_statistics_summary, timedelta: _timedelta_statistics_summary, type(None): _none_type_summary}</code>  <code>module-attribute</code>","text":""},{"location":"reference/utils/#tablite.utils-classes","title":"Classes","text":""},{"location":"reference/utils/#tablite.utils-functions","title":"Functions","text":""},{"location":"reference/utils/#tablite.utils.generate_random_string","title":"<code>tablite.utils.generate_random_string(len)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def generate_random_string(len):\n    return \"\".join(random.choice(letters) for i in range(len))\n</code></pre>"},{"location":"reference/utils/#tablite.utils.type_check","title":"<code>tablite.utils.type_check(var, kind)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def type_check(var, kind):\n    if not isinstance(var, kind):\n        raise TypeError(f\"Expected {kind}, not {type(var)}\")\n</code></pre>"},{"location":"reference/utils/#tablite.utils.sub_cls_check","title":"<code>tablite.utils.sub_cls_check(c, kind)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def sub_cls_check(c, kind):\n    if not issubclass(type(c), kind):\n        raise TypeError(f\"Expected {kind}, not {type(c)}\")\n</code></pre>"},{"location":"reference/utils/#tablite.utils.name_check","title":"<code>tablite.utils.name_check(options, *names)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def name_check(options, *names):\n    for n in names:\n        if n not in options:\n            raise ValueError(f\"{n} not in {options}\")\n</code></pre>"},{"location":"reference/utils/#tablite.utils.unique_name","title":"<code>tablite.utils.unique_name(wanted_name, set_of_names)</code>","text":"<p>returns a wanted_name as wanted_name_i given a list of names which guarantees unique naming.</p> Source code in <code>tablite/utils.py</code> <pre><code>def unique_name(wanted_name, set_of_names):\n    \"\"\"\n    returns a wanted_name as wanted_name_i given a list of names\n    which guarantees unique naming.\n    \"\"\"\n    if not isinstance(set_of_names, set):\n        set_of_names = set(set_of_names)\n    name, i = wanted_name, 1\n    while name in set_of_names:\n        name = f\"{wanted_name}_{i}\"\n        i += 1\n    return name\n</code></pre>"},{"location":"reference/utils/#tablite.utils.expression_interpreter","title":"<code>tablite.utils.expression_interpreter(expression, columns)</code>","text":"<p>Interprets valid expressions such as:</p> <pre><code>\"all((A==B, C!=4, 200&lt;D))\"\n</code></pre> as <p>def _f(A,B,C,D):     return all((A==B, C!=4, 200&lt;D))</p> <p>using python's compiler.</p> Source code in <code>tablite/utils.py</code> <pre><code>def expression_interpreter(expression, columns):\n    \"\"\"\n    Interprets valid expressions such as:\n\n        \"all((A==B, C!=4, 200&lt;D))\"\n\n    as:\n        def _f(A,B,C,D):\n            return all((A==B, C!=4, 200&lt;D))\n\n    using python's compiler.\n    \"\"\"\n    if not isinstance(expression, str):\n        raise TypeError(f\"`{expression}` is not a str\")\n    if not isinstance(columns, list):\n        raise TypeError\n    if not all(isinstance(i, str) for i in columns):\n        raise TypeError\n\n    req_columns = \", \".join(i for i in columns if i in expression)\n    script = f\"def f({req_columns}):\\n    return {expression}\"\n    tree = ast.parse(script)\n    code = compile(tree, filename=\"blah\", mode=\"exec\")\n    namespace = {}\n    exec(code, namespace)\n    f = namespace[\"f\"]\n    if not callable(f):\n        raise ValueError(f\"The expression could not be parse: {expression}\")\n    return f\n</code></pre>"},{"location":"reference/utils/#tablite.utils.intercept","title":"<code>tablite.utils.intercept(A, B)</code>","text":"<p>Enables calculation of the intercept of two range objects. Used to determine if a datablock contains a slice.</p> PARAMETER  DESCRIPTION <code>A</code> <p>range</p> <p> </p> <code>B</code> <p>range</p> <p> </p> RETURNS DESCRIPTION <code>range</code> <p>The intercept of ranges A and B.</p> Source code in <code>tablite/utils.py</code> <pre><code>def intercept(A, B):\n    \"\"\"Enables calculation of the intercept of two range objects.\n    Used to determine if a datablock contains a slice.\n\n    Args:\n        A: range\n        B: range\n\n    Returns:\n        range: The intercept of ranges A and B.\n    \"\"\"\n    type_check(A, range)\n    type_check(B, range)\n\n    if A.step &lt; 1:\n        A = range(A.stop + 1, A.start + 1, 1)\n    if B.step &lt; 1:\n        B = range(B.stop + 1, B.start + 1, 1)\n\n    if len(A) == 0:\n        return range(0)\n    if len(B) == 0:\n        return range(0)\n\n    if A.stop &lt;= B.start:\n        return range(0)\n    if A.start &gt;= B.stop:\n        return range(0)\n\n    if A.start &lt;= B.start:\n        if A.stop &lt;= B.stop:\n            start, end = B.start, A.stop\n        elif A.stop &gt; B.stop:\n            start, end = B.start, B.stop\n        else:\n            raise ValueError(\"bad logic\")\n    elif A.start &lt; B.stop:\n        if A.stop &lt;= B.stop:\n            start, end = A.start, A.stop\n        elif A.stop &gt; B.stop:\n            start, end = A.start, B.stop\n        else:\n            raise ValueError(\"bad logic\")\n    else:\n        raise ValueError(\"bad logic\")\n\n    a_steps = math.ceil((start - A.start) / A.step)\n    a_start = (a_steps * A.step) + A.start\n\n    b_steps = math.ceil((start - B.start) / B.step)\n    b_start = (b_steps * B.step) + B.start\n\n    if A.step == 1 or B.step == 1:\n        start = max(a_start, b_start)\n        step = max(A.step, B.step)\n        return range(start, end, step)\n    elif A.step == B.step:\n        a, b = min(A.start, B.start), max(A.start, B.start)\n        if (b - a) % A.step != 0:  # then the ranges are offset.\n            return range(0)\n        else:\n            return range(b, end, step)\n    else:\n        # determine common step size:\n        step = max(A.step, B.step) if math.gcd(A.step, B.step) != 1 else A.step * B.step\n        # examples:\n        # 119 &lt;-- 17 if 1 != 1 else 119 &lt;-- max(7, 17) if math.gcd(7, 17) != 1 else 7 * 17\n        #  30 &lt;-- 30 if 3 != 1 else 90 &lt;-- max(3, 30) if math.gcd(3, 30) != 1 else 3*30\n        if A.step &lt; B.step:\n            for n in range(a_start, end, A.step):  # increment in smallest step to identify the first common value.\n                if n &lt; b_start:\n                    continue\n                elif (n - b_start) % B.step == 0:\n                    return range(n, end, step)  # common value found.\n        else:\n            for n in range(b_start, end, B.step):\n                if n &lt; a_start:\n                    continue\n                elif (n - a_start) % A.step == 0:\n                    return range(n, end, step)\n\n        return range(0)\n</code></pre>"},{"location":"reference/utils/#tablite.utils.summary_statistics","title":"<code>tablite.utils.summary_statistics(values, counts)</code>","text":"<p>values: any type counts: integer</p> <p>returns dict with: - min (int/float, length of str, date) - max (int/float, length of str, date) - mean (int/float, length of str, date) - median (int/float, length of str, date) - stdev (int/float, length of str, date) - mode (int/float, length of str, date) - distinct (number of distinct values) - iqr (int/float, length of str, date) - sum (int/float, length of str, date) - histogram (2 arrays: values, count of each values)</p> Source code in <code>tablite/utils.py</code> <pre><code>def summary_statistics(values, counts):\n    \"\"\"\n    values: any type\n    counts: integer\n\n    returns dict with:\n    - min (int/float, length of str, date)\n    - max (int/float, length of str, date)\n    - mean (int/float, length of str, date)\n    - median (int/float, length of str, date)\n    - stdev (int/float, length of str, date)\n    - mode (int/float, length of str, date)\n    - distinct (number of distinct values)\n    - iqr (int/float, length of str, date)\n    - sum (int/float, length of str, date)\n    - histogram (2 arrays: values, count of each values)\n    \"\"\"\n    # determine the dominant datatype:\n    dtypes = defaultdict(int)\n    most_frequent, most_frequent_dtype = 0, int\n    for v, c in zip(values, counts):\n        dtype = type(v)\n        total = dtypes[dtype] + c\n        dtypes[dtype] = total\n        if total &gt; most_frequent:\n            most_frequent_dtype = dtype\n            most_frequent = total\n\n    if most_frequent == 0:\n        return {}\n\n    most_frequent_dtype = max(dtypes, key=dtypes.get)\n    mask = [type(v) == most_frequent_dtype for v in values]\n    v = list(compress(values, mask))\n    c = list(compress(counts, mask))\n\n    f = summary_methods.get(most_frequent_dtype, int)\n    result = f(v, c)\n    result[\"distinct\"] = len(values)\n    result[\"summary type\"] = most_frequent_dtype.__name__\n    result[\"histogram\"] = [values, counts]\n    assert set(result.keys()) == required_keys, \"Key missing!\"\n    return result\n</code></pre>"},{"location":"reference/utils/#tablite.utils.date_range","title":"<code>tablite.utils.date_range(start, stop, step)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def date_range(start, stop, step):\n    if not isinstance(start, datetime):\n        raise TypeError(\"start is not datetime\")\n    if not isinstance(stop, datetime):\n        raise TypeError(\"stop is not datetime\")\n    if not isinstance(step, timedelta):\n        raise TypeError(\"step is not timedelta\")\n    n = (stop - start) // step\n    return [start + step * i for i in range(n)]\n</code></pre>"},{"location":"reference/utils/#tablite.utils.dict_to_rows","title":"<code>tablite.utils.dict_to_rows(d)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def dict_to_rows(d):\n    type_check(d, dict)\n    rows = []\n    max_length = max(len(i) for i in d.values())\n    order = list(d.keys())\n    rows.append(order)\n    for i in range(max_length):\n        row = [d[k][i] for k in order]\n        rows.append(row)\n    return rows\n</code></pre>"},{"location":"reference/utils/#tablite.utils.calc_col_count","title":"<code>tablite.utils.calc_col_count(letters: str)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def calc_col_count(letters: str):\n    ord_nil = ord(\"A\") - 1\n    cols_per_letter = ord(\"Z\") - ord_nil\n    col_count = 0\n\n    for i, v in enumerate(reversed(letters)):\n        col_count = col_count + (ord(v) - ord_nil) * pow(cols_per_letter, i)\n\n    return col_count\n</code></pre>"},{"location":"reference/utils/#tablite.utils.calc_true_dims","title":"<code>tablite.utils.calc_true_dims(sheet)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def calc_true_dims(sheet):\n    src = sheet._get_source()\n    max_col, max_row = 0, 0\n\n    regex = re.compile(\"\\d+\")\n\n    def handleStartElement(name, attrs):\n        nonlocal max_col, max_row\n\n        if name == \"c\":\n            last_index = attrs[\"r\"]\n            idx, _ = next(regex.finditer(last_index)).span()\n            letters, digits = last_index[0:idx], int(last_index[idx:])\n\n            col_idx, row_idx = calc_col_count(letters), digits\n\n            max_col, max_row = max(max_col, col_idx), max(max_row, row_idx)\n\n    parser = expat.ParserCreate()\n    parser.buffer_text = True\n    parser.StartElementHandler = handleStartElement\n    parser.ParseFile(src)\n\n    return max_col, max_row\n</code></pre>"},{"location":"reference/utils/#tablite.utils.fixup_worksheet","title":"<code>tablite.utils.fixup_worksheet(worksheet)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def fixup_worksheet(worksheet):\n    try:\n        ws_cols, ws_rows = calc_true_dims(worksheet)\n\n        worksheet._max_column = ws_cols\n        worksheet._max_row = ws_rows\n    except Exception as e:\n        logging.error(f\"Failed to fetch true dimensions: {e}\")\n</code></pre>"},{"location":"reference/utils/#tablite.utils.update_access_time","title":"<code>tablite.utils.update_access_time(path)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def update_access_time(path):\n    path = Path(path)\n    stat = path.stat()\n    os.utime(path, (now(), stat.st_mtime))\n</code></pre>"},{"location":"reference/utils/#tablite.utils.load_numpy","title":"<code>tablite.utils.load_numpy(path)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def load_numpy(path):\n    update_access_time(path)\n\n    return np.load(path, allow_pickle=True, fix_imports=False)\n</code></pre>"},{"location":"reference/utils/#tablite.utils.select_type_name","title":"<code>tablite.utils.select_type_name(dtypes: dict)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def select_type_name(dtypes: dict):\n    dtypes = [t for t in dtypes.items() if t[0] != NoneType]\n\n    if len(dtypes) == 0:\n        return \"empty\"\n\n    (best_type, _), *_ = sorted(dtypes, key=lambda t: t[1], reverse=True)\n\n    return best_type.__name__\n</code></pre>"},{"location":"reference/utils/#tablite.utils.get_predominant_types","title":"<code>tablite.utils.get_predominant_types(table, all_dtypes=None)</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def get_predominant_types(table, all_dtypes=None):\n    if all_dtypes is None:\n        all_dtypes = table.types()\n\n    dtypes = {\n        k: select_type_name(v)\n        for k, v in all_dtypes.items()\n    }\n\n    return dtypes\n</code></pre>"},{"location":"reference/utils/#tablite.utils.py_to_nim_encoding","title":"<code>tablite.utils.py_to_nim_encoding(encoding: str) -&gt; str</code>","text":"Source code in <code>tablite/utils.py</code> <pre><code>def py_to_nim_encoding(encoding: str) -&gt; str:\n    if encoding is None or encoding.lower() in [\"ascii\", \"utf8\", \"utf-8\", \"utf-8-sig\"]:\n        return \"ENC_UTF8\"\n    elif encoding.lower() in [\"utf16\", \"utf-16\"]:\n        return \"ENC_UTF16\"\n    elif encoding in Config.NIM_SUPPORTED_CONV_TYPES:\n        return f\"ENC_CONV|{encoding}\"\n\n    raise NotImplementedError(f\"encoding not implemented: {encoding}\")\n</code></pre>"},{"location":"reference/version/","title":"Version","text":""},{"location":"reference/version/#tablite.version","title":"<code>tablite.version</code>","text":""},{"location":"reference/version/#tablite.version-attributes","title":"Attributes","text":""},{"location":"reference/version/#tablite.version.__version_info__","title":"<code>tablite.version.__version_info__ = (major, minor, patch)</code>  <code>module-attribute</code>","text":""},{"location":"reference/version/#tablite.version.__version__","title":"<code>tablite.version.__version__ = '.'.join(str(i) for i in __version_info__)</code>  <code>module-attribute</code>","text":""}]}
\ No newline at end of file
diff --git a/master/sitemap.xml b/master/sitemap.xml
index 058b25af..dc824927 100644
--- a/master/sitemap.xml
+++ b/master/sitemap.xml
@@ -2,152 +2,147 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
     <url>
          <loc>https://root-11.github.io/tablite/master/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/benchmarks/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/changelog/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/tutorial/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/base/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/config/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/core/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/datasets/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/datatypes/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/diff/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/export_utils/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/file_reader_utils/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/groupby_utils/</loc>
-         <lastmod>2024-04-04</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>https://root-11.github.io/tablite/master/reference/groupbys/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/import_utils/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/imputation/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/joins/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/lookup/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/match/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/merge/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/mp_utils/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/nimlite/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/pivots/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/redux/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/reindex/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/sort_utils/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/sortation/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/tools/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/utils/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://root-11.github.io/tablite/master/reference/version/</loc>
-         <lastmod>2024-04-04</lastmod>
+         <lastmod>2024-04-05</lastmod>
          <changefreq>daily</changefreq>
     </url>
 </urlset>
\ No newline at end of file
diff --git a/master/sitemap.xml.gz b/master/sitemap.xml.gz
index 380250ac1c84f2eda1c5d1fa3f8ee3f42f991a57..0d1ff140d08b62192cd36c10dda39650d8e30f21 100644
GIT binary patch
literal 395
zcmV;60d)Q!iwFoEs1IfW|8r?{Wo=<_E_iKh0M(e!Zi6rk#_xR!#J!}gHfftEz3mCM
za}~fq)+Ejxr+?mlp{=IgryU$c0vz+{r%zU5sCQ>)iz84p=(pv%T9pO(4twLrZTb1}
zzI-Wn&7w|ZBXE(EecYB4b9htgbUIbhFgP7zg*2+zP5B|Jdr+;a*Roj@dCUU0yX&Ye
zcFn93vkW2fa=orb!&7Q2gNk))vxLf845Vr`r$4@(;|}{~v)Vi@S9w0?lzZ$Ut(&wT
zVIcT!dTs2bRu7RImip!T6JeV@o1CUY6aahEwKxi3<-|xvTLGv915mC5P_2$23b;c*
zm{Axq$?~|@oXdivIB32E5Jqi=K@>2Y0}}5O8!OA{!C2T6=pINQ{YaQXdl5)(oX~>F
z;3;n@x!Dwj{e{NMGTI^@QV@mgG<TCMVxUo07vh4zO~V^^U68~a%n^k(djx$t3nMnZ
p2U*Nf=D|H<%R9FjQJBy2D&zk1@c)^wm;4Fc`~V`c#doz7002_WyLtcs

literal 395
zcmV;60d)Q!iwFn_XAWip|8r?{Wo=<_E_iKh0M(e!Zi6rk#_xLy#Jz-8J8ToBw>`mj
zt^$~lHN=_Y^v~NbwAIx6w1cBafMY)W^vOyL&F(zA;s_Ki`fa(c>aqae<6ynnmY*N*
ztCw=uJ~fG41TJ#2kK1x$4sS}GPNynbhFOPLAsH3>DL+JY530I)E!(Fek44~icO8wx
zzFkyemLWu5t=E;YJf*I(s91L{OQ@{HK&nwo`s3R<KI71C>do`2US>|Y#~#x9NqYk$
z!FM}o>n@FYh}^K$FV~+4yX@ICYdS;$us2<YMgS`(MzY!oKqVM~avgx`bOcerJ^Ila
zVaO!Q<3V#S3y$KT`4T`FwH-%Mz;F&oyiaVMET>27U{9b2Ac6FTFoo_Sms}RKorP9;
z22Xh(%pI~Q>@T!lmeCIJkb)@WS#v+hA_g+DTBkV(+%&wMuM3ixgFT|K4wYa?XJN$F
p4<L&<$~?FiY<cH4BMS3bUS-_>c>X{0^^(8)+aHvvb|-2T000V~ySe}X

diff --git a/master/tablite/core.py b/master/tablite/core.py
index b784a51a..31cbd823 100644
--- a/master/tablite/core.py
+++ b/master/tablite/core.py
@@ -17,12 +17,12 @@
 from tablite import lookup
 from tablite import match
 from tablite import sortation
-from tablite import groupbys
 from tablite import pivots
 from tablite import imputation
 from tablite import diff
 from tablite.config import Config
 from tablite.nimlite import column_select as _column_select, ColumnSelectorDict, ValidSkipEmpty
+from tablite.nimlite import groupby as _groupby
 from mplite import TaskManager as _TaskManager
 
 logging.getLogger("lml").propagate = False
@@ -611,7 +611,7 @@ def groupby(self, keys, functions, tqdm=_tqdm, pbar=None):
             https://github.com/root-11/tablite/blob/master/tests/test_groupby.py
 
         """
-        return groupbys.groupby(self, keys, functions, tqdm=tqdm, pbar=pbar)
+        return _groupby(self, keys, functions, tqdm)
 
     def pivot(self, rows, columns, functions, values_as_rows=True, tqdm=_tqdm, pbar=None):
         """
diff --git a/master/tablite/groupby_utils.py b/master/tablite/groupby_utils.py
index 9f38c833..3b6defcb 100644
--- a/master/tablite/groupby_utils.py
+++ b/master/tablite/groupby_utils.py
@@ -1,201 +1,13 @@
-from collections import defaultdict
-from datetime import date, time, datetime, timedelta  # noqa
-
-
-class GroupbyFunction(object):
-    pass
-
-
-class Limit(GroupbyFunction):
-    def __init__(self):
-        self.value = None
-        self.f = None
-
-    def update(self, value):
-        if value is None:
-            pass
-        elif self.value is None:
-            self.value = value
-        else:
-            self.value = self.f((value, self.value))
-
-
-class Max(Limit):
-    def __init__(self):
-        super().__init__()
-        self.f = max
-
-
-class Min(Limit):
-    def __init__(self):
-        super().__init__()
-        self.f = min
-
-
-class Sum(GroupbyFunction):
-    def __init__(self):
-        self.value = 0
-
-    def update(self, value):
-        if isinstance(value, (type(None), date, time, datetime, str)):
-            raise ValueError(f"Sum of {type(value)} doesn't make sense.")
-        self.value += value
-
-
-class Product(GroupbyFunction):
-    def __init__(self) -> None:
-        self.value = 1
-
-    def update(self, value):
-        self.value *= value
-
-
-class First(GroupbyFunction):
-    empty = (None,)
-    # we will never receive a tuple, so using (None,) as the initial
-    # value will assure that IF None is the first value, then it can
-    # be captured correctly.
-
-    def __init__(self):
-        self.value = self.empty
-
-    def update(self, value):
-        if self.value is First.empty:
-            self.value = value
-
-
-class Last(GroupbyFunction):
-    def __init__(self):
-        self.value = None
-
-    def update(self, value):
-        self.value = value
-
-
-class Count(GroupbyFunction):
-    def __init__(self):
-        self.value = 0
-
-    def update(self, value):
-        self.value += 1
-
-
-class CountUnique(GroupbyFunction):
-    def __init__(self):
-        self.items = set()
-        self.value = None
-
-    def update(self, value):
-        self.items.add(value)
-        self.value = len(self.items)
-
-
-class Average(GroupbyFunction):
-    def __init__(self):
-        self.sum = 0
-        self.count = 0
-        self.value = 0
-
-    def update(self, value):
-        if isinstance(value, (date, time, datetime, str)):
-            raise ValueError(f"Sum of {type(value)} doesn't make sense.")
-        if value is not None:
-            self.sum += value
-            self.count += 1
-            self.value = self.sum / self.count
-
-
-class StandardDeviation(GroupbyFunction):
-    """
-    Uses J.P. Welfords (1962) algorithm.
-    For details see https://en.wikipedia.org/wiki/Algorithms_for_calculating_variance#Online_algorithm
-    """
-
-    def __init__(self):
-        self.count = 0
-        self.mean = 0
-        self.c = 0.0
-
-    def update(self, value):
-        if isinstance(value, (date, time, datetime, str)):
-            raise ValueError(f"Std.dev. of {type(value)} doesn't make sense.")
-        if value is not None:
-            self.count += 1
-            dt = value - self.mean
-            self.mean += dt / self.count
-            self.c += dt * (value - self.mean)
-
-    @property
-    def value(self):
-        if self.count <= 1:
-            return 0.0
-        variance = self.c / (self.count - 1)
-        return variance ** (1 / 2)
-
-
-class Histogram(GroupbyFunction):
-    def __init__(self):
-        self.hist = defaultdict(int)
-
-    def update(self, value):
-        self.hist[value] += 1
-
-
-class Median(Histogram):
-    def __init__(self):
-        super().__init__()
-
-    @property
-    def value(self):
-        if not self.hist:
-            raise ValueError("No data.")
-
-        keys = len(self.hist.keys())
-        if keys == 1:
-            for k in self.hist:
-                return k
-        elif keys % 2 == 0:
-            A, B, total, midpoint = None, None, 0, sum(self.hist.values()) / 2
-            for k, v in sorted(self.hist.items()):
-                total += v
-                A, B = B, k
-                if total > midpoint:
-                    return (A + B) / 2
-        else:
-            midpoint = sum(self.hist.values()) / 2
-            total = 0
-            for k, v in sorted(self.hist.items()):
-                total += v
-                if total > midpoint:
-                    return k
-
-
-class Mode(Histogram):
-    def __init__(self):
-        super().__init__()
-
-    @property
-    def value(self):
-        L = [(v, k) for k, v in self.hist.items()]
-        L.sort(reverse=True)
-        _, most_frequent = L[0]  # top of the list.
-        return most_frequent
-
-
 class GroupBy(object):
-    max = Max  # shortcuts to avoid having to type a long list of imports.
-    min = Min
-    sum = Sum
-    product = Product
-    first = First
-    last = Last
-    count = Count
-    count_unique = CountUnique
-    avg = Average
-    stdev = StandardDeviation
-    median = Median
-    mode = Mode
-
-    functions = [Max, Min, Sum, First, Last, Product, Count, CountUnique, Average, StandardDeviation, Median, Mode]
-
-    function_names = {f.__name__: f for f in functions}
+    max = "max"
+    min = "min"
+    sum = "sum"
+    product = "product"
+    first = "first"
+    last = "last"
+    count = "count"
+    count_unique = "count_unique"
+    avg = "avg"
+    stdev = "stdev"
+    median = "median"
+    mode = "mode"
\ No newline at end of file
diff --git a/master/tablite/groupbys.py b/master/tablite/groupbys.py
deleted file mode 100644
index c7f2352e..00000000
--- a/master/tablite/groupbys.py
+++ /dev/null
@@ -1,201 +0,0 @@
-from collections import defaultdict
-
-from tablite.config import Config
-from tablite.base import BaseTable, Column
-from tablite.groupby_utils import GroupBy, GroupbyFunction
-from tablite.utils import unique_name
-
-from tqdm import tqdm as _tqdm
-
-
-def groupby(
-    T, keys, functions, tqdm=_tqdm, pbar=None
-):  # TODO: This is single core code.
-    """
-    keys: column names for grouping.
-    functions: [optional] list of column names and group functions (See GroupyBy class)
-    returns: table
-
-    Example:
-    ```
-    >>> t = Table()
-    >>> t.add_column('A', data=[1, 1, 2, 2, 3, 3] * 2)
-    >>> t.add_column('B', data=[1, 2, 3, 4, 5, 6] * 2)
-    >>> t.add_column('C', data=[6, 5, 4, 3, 2, 1] * 2)
-    >>> t.show()
-    +=====+=====+=====+
-    |  A  |  B  |  C  |
-    | int | int | int |
-    +-----+-----+-----+
-    |    1|    1|    6|
-    |    1|    2|    5|
-    |    2|    3|    4|
-    |    2|    4|    3|
-    |    3|    5|    2|
-    |    3|    6|    1|
-    |    1|    1|    6|
-    |    1|    2|    5|
-    |    2|    3|    4|
-    |    2|    4|    3|
-    |    3|    5|    2|
-    |    3|    6|    1|
-    +=====+=====+=====+
-    >>> g = t.groupby(keys=['A', 'C'], functions=[('B', gb.sum)])
-    >>> g.show()
-    +===+===+===+======+
-    | # | A | C |Sum(B)|
-    |row|int|int| int  |
-    +---+---+---+------+
-    |0  |  1|  6|     2|
-    |1  |  1|  5|     4|
-    |2  |  2|  4|     6|
-    |3  |  2|  3|     8|
-    |4  |  3|  2|    10|
-    |5  |  3|  1|    12|
-    +===+===+===+======+
-    ```
-
-    Cheat sheet:
-
-    list of unique values
-    ```
-    >>> g1 = t.groupby(keys=['A'], functions=[])
-    >>> g1['A'][:]
-    [1,2,3]
-    ```
-    alternatively:
-    ```
-    >>> t['A'].unique()
-    [1,2,3]
-    ```
-    list of unique values, grouped by longest combination.
-    ```
-    >>> g2 = t.groupby(keys=['A', 'B'], functions=[])
-    >>> g2['A'][:], g2['B'][:]
-    ([1,1,2,2,3,3], [1,2,3,4,5,6])
-    ```
-    alternatively use:
-    ```
-    >>> list(zip(*t.index('A', 'B').keys()))
-    [(1,1,2,2,3,3) (1,2,3,4,5,6)]
-    ```
-
-    A key (unique values) and count hereof.
-    ```
-    >>> g3 = t.groupby(keys=['A'], functions=[('A', gb.count)])
-    >>> g3['A'][:], g3['Count(A)'][:]
-    ([1,2,3], [4,4,4])
-    ```
-    alternatively use:
-    ```
-    >>> t['A'].histogram()
-    ([1,2,3], [4,4,4])
-    ```
-    for more examples see: https://github.com/root-11/tablite/blob/master/tests/test_groupby.py
-
-    """
-    if not isinstance(keys, list):
-        raise TypeError("expected keys as a list of column names")
-
-    if keys:
-        if len(set(keys)) != len(keys):
-            duplicates = [k for k in keys if keys.count(k) > 1]
-            s = "" if len(duplicates) > 1 else "s"
-            raise ValueError(
-                f"duplicate key{s} found across rows and columns: {duplicates}"
-            )
-
-    if not isinstance(functions, list):
-        raise TypeError(
-            f"Expected functions to be a list of tuples. Got {type(functions)}"
-        )
-
-    if not keys + functions:
-        raise ValueError("No keys or functions?")
-
-    if not all(len(i) == 2 for i in functions):
-        raise ValueError(
-            f"Expected each tuple in functions to be of length 2. \nGot {functions}"
-        )
-
-    if not all(isinstance(a, str) for a, _ in functions):
-        L = [(a, type(a)) for a, _ in functions if not isinstance(a, str)]
-        raise ValueError(
-            f"Expected column names in functions to be strings. Found: {L}"
-        )
-
-    if not all(
-        issubclass(b, GroupbyFunction) and b in GroupBy.functions for _, b in functions
-    ):
-        L = [b for _, b in functions if b not in GroupBy._functions]
-        if len(L) == 1:
-            singular = f"function {L[0]} is not in GroupBy.functions"
-            raise ValueError(singular)
-        else:
-            plural = f"the functions {L} are not in GroupBy.functions"
-            raise ValueError(plural)
-
-    # only keys will produce unique values for each key group.
-    if keys and not functions:
-        cols = list(zip(*T.index(*keys)))
-        result = T.__class__()
-
-        pbar = tqdm(total=len(keys), desc="groupby") if pbar is None else pbar
-
-        for col_name, col in zip(keys, cols):
-            result[col_name] = col
-
-            pbar.update(1)
-        return result
-
-    # grouping is required...
-    # 1. Aggregate data.
-    aggregation_functions = defaultdict(dict)
-    cols = keys + [col_name for col_name, _ in functions]
-    seen, L = set(), []
-    for c in cols:  # maintains order of appearance.
-        if c not in seen:
-            seen.add(c)
-            L.append(c)
-
-    # there's a table of values.
-    data = T[L]
-    if isinstance(data, Column):
-        tbl = BaseTable()
-        tbl[L[0]] = data
-    else:
-        tbl = data
-
-    pbar = (
-        tqdm(desc="groupby", total=len(tbl), disable=Config.TQDM_DISABLE)
-        if pbar is None
-        else pbar
-    )
-
-    for row in tbl.rows:
-        d = {col_name: value for col_name, value in zip(L, row)}
-        key = tuple([d[k] for k in keys])
-        agg_functions = aggregation_functions.get(key)
-        if not agg_functions:
-            aggregation_functions[key] = agg_functions = [
-                (col_name, f()) for col_name, f in functions
-            ]
-        for col_name, f in agg_functions:
-            f.update(d[col_name])
-
-        pbar.update(1)
-
-    # 2. make dense table.
-    cols = [[] for _ in cols]
-    for key_tuple, funcs in aggregation_functions.items():
-        for ix, key_value in enumerate(key_tuple):
-            cols[ix].append(key_value)
-        for ix, (_, f) in enumerate(funcs, start=len(keys)):
-            cols[ix].append(f.value)
-
-    new_names = keys + [f"{f.__name__}({col_name})" for col_name, f in functions]
-    result = type(T)()  # New Table.
-    for ix, (col_name, data) in enumerate(zip(new_names, cols)):
-        revised_name = unique_name(col_name, result.columns)
-        result[revised_name] = data
-    return result
diff --git a/master/tablite/nimlite.py b/master/tablite/nimlite.py
index 162b90da..92e711db 100644
--- a/master/tablite/nimlite.py
+++ b/master/tablite/nimlite.py
@@ -307,5 +307,8 @@ def repaginate(column: Column):
 def nearest_neighbour(T: BaseTable, sources: Union[list[str], None], missing: Union[list, None], targets: Union[list[str], None], tqdm=_tqdm):
     return nl.nearest_neighbour(T, sources, list(missing), targets, tqdm)
 
+def groupby(T, keys, functions, tqdm=_tqdm):
+    return nl.groupby(T, keys, functions, tqdm)
+
 def filter(table: BaseTable, expressions: list[FilterDict], type: FilterType, tqdm = _tqdm):
-    return nl.filter(table, expressions, type, tqdm)
\ No newline at end of file
+    return nl.filter(table, expressions, type, tqdm)
diff --git a/master/tablite/pivots.py b/master/tablite/pivots.py
index 0c99f9fc..65de8a95 100644
--- a/master/tablite/pivots.py
+++ b/master/tablite/pivots.py
@@ -3,12 +3,26 @@
 
 from tablite.base import BaseTable
 from tablite.utils import unique_name, sub_cls_check
-from tablite.groupbys import groupby
+from tablite.nimlite import groupby
 from tablite.config import Config
 
 from tqdm import tqdm as _tqdm
 
 
+def acc2Name(acc: str) -> str:
+    arr = ["max", "min", "sum", "product", "first", "last", "count", "median", "mode"]
+    if acc in arr:
+        return acc.capitalize()
+    elif acc == "count_unique":
+        return "CountUnique"
+    elif acc == "avg":
+        return "Average"
+    elif acc == "stdev":
+        return "StandardDeviation"
+    else:
+        raise ValueError(f"unknown accumulator - {acc}")
+
+
 def pivot(T, rows, columns, functions, values_as_rows=True, tqdm=_tqdm, pbar=None):
     """
     param: rows: column names to keep as rows
@@ -84,7 +98,7 @@ def pivot(T, rows, columns, functions, values_as_rows=True, tqdm=_tqdm, pbar=Non
 
         pbar = tqdm(total=total, desc="pivot")
 
-    grpby = groupby(T, keys, functions, tqdm=tqdm, pbar=pbar)
+    grpby = groupby(T, keys, functions, tqdm=tqdm)
     Constr = type(T)
 
     if len(grpby) == 0:  # return empty table. This must be a test?
@@ -129,7 +143,7 @@ def pivot(T, rows, columns, functions, values_as_rows=True, tqdm=_tqdm, pbar=Non
         cols = [[] for _ in range(n)]
         for row, ix in row_key_index.items():
             for col_name, f in functions:
-                cols[-1].append(f"{f.__name__}({col_name})")
+                cols[-1].append(f"{acc2Name(f)}({col_name})")
                 for col_ix, v in enumerate(row):
                     cols[col_ix].append(v)
 
@@ -168,7 +182,7 @@ def pivot(T, rows, columns, functions, values_as_rows=True, tqdm=_tqdm, pbar=Non
             for f, v in zip(functions, func_key):
                 agg_col, func = f
                 terms = ",".join([agg_col] + [f"{col_name}={value}" for col_name, value in zip(columns, col_key)])
-                col_name = f"{func.__name__}({terms})"
+                col_name = f"{acc2Name(func)}({terms})"
                 col_name = unique_name(col_name, result.columns)
                 names.append(col_name)
                 cols.append([None for _ in range(col_length)])
diff --git a/master/tests/test_groupby_and_pivot.py b/master/tests/test_groupby_and_pivot.py
index 7390584b..0e5d10a9 100644
--- a/master/tests/test_groupby_and_pivot.py
+++ b/master/tests/test_groupby_and_pivot.py
@@ -1,8 +1,9 @@
 from tablite.core import Table
-from tablite.groupbys import GroupBy as gb
+from tablite.groupby_utils import GroupBy as gb
 from random import seed, choice
 import numpy as np
 import pytest
+import statistics
 
 
 @pytest.fixture(autouse=True)  # this resets the HDF5 file for every test.
@@ -89,8 +90,10 @@ def test_groupby_missing_args():
     t.add_column("B", data=[1, 2, 3, 4, 5, 6] * 2)
     try:
         _ = t.groupby(keys=[], functions=[])  # value error. DONE.
-        assert False, "the line above should raise ValueError"
-    except ValueError:
+        assert False
+    except Exception as e:
+        assert type(e).__name__ == "ValueError"
+        assert type(e).__module__ == "nimpy"
         assert True
 
     g0 = t.groupby(keys=[], functions=[("A", gb.sum)])
@@ -380,3 +383,128 @@ def test_reverse_pivot():
     # +===+=====+===================+================+================+================+
     assert len(t2) == 5 and len(t2.columns) == 5
     assert t2["Count(ahe,ahe=e)"][0] is None
+
+def test_groupby_funcs():
+    # ======== MEDIAN ==========
+
+    def createTable(valArr):
+        return Table({
+            'k': [1 for _ in valArr],
+            'v': valArr,
+        })
+    
+    t = createTable([1, 2, 3, 4, 5]).groupby(keys=['k'], functions=[('v', gb.median)])
+    assert t["Median(v)"] == [3]
+
+    t = createTable([1, 2, 3, 6, 7, 8]).groupby(keys=['k'], functions=[('v', gb.median)])
+    assert t["Median(v)"] == [4.5]
+
+    t = createTable([3]).groupby(keys=['k'], functions=[('v', gb.median)])
+    assert t["Median(v)"] == [3]
+
+    t = createTable([3, 3]).groupby(keys=['k'], functions=[('v', gb.median)])
+    assert t["Median(v)"] == [3]
+
+    t = createTable([3, 3, 3]).groupby(keys=['k'], functions=[('v', gb.median)])
+    assert t["Median(v)"] == [3]
+    
+    t = createTable([3, 3, 6, 6, 9, 9]).groupby(keys=['k'], functions=[('v', gb.median)])
+    assert t["Median(v)"] == [6]
+
+    t = createTable([3, 3, 3, 9, 9, 9]).groupby(keys=['k'], functions=[('v', gb.median)])
+    assert t["Median(v)"] == [6]
+
+    t = createTable([-1, -1, 0, 1, 1]).groupby(keys=['k'], functions=[('v', gb.median)])
+    assert t["Median(v)"] == [0]
+
+    t = createTable([-1, -1, 0, 0, 1, 1]).groupby(keys=['k'], functions=[('v', gb.median)])
+    assert t["Median(v)"] == [0]
+
+    t = createTable([5, 4, 6, 3, 7, 2, 8, 1, 9]).groupby(keys=['k'], functions=[('v', gb.median)])
+    assert t["Median(v)"] == [5]
+
+    t = createTable([i / 10 for i in range(10)]).groupby(keys=['k'], functions=[('v', gb.median)])
+    assert t["Median(v)"] == [0.45]
+
+    t = createTable([i / 10 for i in range(1, 10)]).groupby(keys=['k'], functions=[('v', gb.median)])
+    assert t["Median(v)"] == [0.5]
+    # ==========================
+
+    # ========== MAX ===========
+    t = createTable([-2, -1, 0, 1, 2, 3]).groupby(keys=['k'], functions=[('v', gb.max)])
+    assert t["Max(v)"] == [3]
+    # ==========================
+
+    # ========== MIN ===========
+    t = createTable([-2, -1, 0, 1, 2, 3]).groupby(keys=['k'], functions=[('v', gb.min)])
+    assert t["Min(v)"] == [-2]
+    # ==========================
+
+    # ========== SUM ===========
+    t = createTable([-2, -1, 0, 1, 2, 3]).groupby(keys=['k'], functions=[('v', gb.sum)])
+    assert t["Sum(v)"] == [3]
+    # ==========================
+
+    # ======== PRODUCT =========
+    L = [1, 2, 3, 4, 5]
+    x = 1
+    for i in L:
+        x *= i
+    t = createTable([1, 2, 3, 4, 5]).groupby(keys=['k'], functions=[('v', gb.product)])
+    assert t["Product(v)"] == [x]
+    # ==========================
+
+    # ========= FIRST ==========
+    t = createTable([-2, -1, 0, 1, 2, 3]).groupby(keys=['k'], functions=[('v', gb.first)])
+    assert t["First(v)"] == [-2]
+    # ==========================
+
+    # ========== LAST ==========
+    t = createTable([-2, -1, 0, 1, 2, 3]).groupby(keys=['k'], functions=[('v', gb.last)])
+    assert t["Last(v)"] == [3]
+    # ==========================
+
+    # ========= COUNT ==========
+    t = createTable([1, 1, 2, 2]).groupby(keys=['k'], functions=[('v', gb.count)])
+    assert t["Count(v)"] == [4]
+    # ==========================
+
+    # ===== COUNT UNIQUE =======
+    t = createTable([1, 1, 2, 2]).groupby(keys=['k'], functions=[('v', gb.count_unique)])
+    assert t["CountUnique(v)"] == [2]
+    # ==========================
+
+    # ======== AVERAGE =========
+    L = [-2, -1, 0, 1, 2, 3]
+    t = createTable(L).groupby(keys=['k'], functions=[('v', gb.avg)])
+    assert t["Average(v)"] == [sum(L) / len(L)]
+
+    L = [0]
+    t = createTable([0]).groupby(keys=['k'], functions=[('v', gb.avg)])
+    assert t["Average(v)"] == [sum(L) / len(L)]
+    # ==========================
+
+    # ========= STDEV ==========
+    L = [1, 1]
+    t = createTable(L).groupby(keys=['k'], functions=[('v', gb.stdev)])
+    assert t["StandardDeviation(v)"] == [0]
+
+    L = [1, 1, 2, 2]
+    t = createTable(L).groupby(keys=['k'], functions=[('v', gb.stdev)])
+    assert t["StandardDeviation(v)"] == [statistics.stdev(L)]
+    # ==========================
+
+    # ========== MODE ==========
+    t = createTable([1]).groupby(keys=['k'], functions=[('v', gb.mode)])
+    assert t["Mode(v)"] == [1]
+    
+    t = createTable([1, 1, 2]).groupby(keys=['k'], functions=[('v', gb.mode)])
+    assert t["Mode(v)"] == [1]
+    
+    t = createTable([1, 1, 2, 3, 3]).groupby(keys=['k'], functions=[('v', gb.mode)])
+    assert t["Mode(v)"] == [3]
+
+    t = createTable([1, 1, 2, 2, 3, 3]).groupby(keys=['k'], functions=[('v', gb.mode)])
+    assert t["Mode(v)"] == [3]
+    # ==========================
+
diff --git a/master/tests/test_groupby_utils.py b/master/tests/test_groupby_utils.py
deleted file mode 100644
index 3e1be71b..00000000
--- a/master/tests/test_groupby_utils.py
+++ /dev/null
@@ -1,121 +0,0 @@
-from tablite.groupby_utils import GroupBy as gb
-import statistics
-
-
-def test_median():
-    def median(values):
-        m = gb.median()
-        for v in values:
-            m.update(v)
-        return m.value
-
-    assert median([1, 2, 3, 4, 5]) == 3
-    assert median([1, 2, 3, 6, 7, 8]) == 4.5
-    assert median([3]) == 3
-    assert median([3, 3]) == 3
-    assert median([3, 3, 3]) == 3
-    assert median([3, 3, 6, 6, 9, 9]) == 6
-    assert median([3, 3, 3, 9, 9, 9]) == 6
-    assert median([-1, -1, 0, 1, 1]) == 0
-    assert median([-1, -1, 0, 0, 1, 1]) == 0
-    assert median([5, 4, 6, 3, 7, 2, 8, 1, 9]) == 5
-    assert median([i / 10 for i in range(10)]) == 0.45
-    assert median([i / 10 for i in range(1, 10)]) == 0.5
-
-
-def test_max():
-    m = gb.max()
-    for i in [-2, -1, 0, 1, 2, 3]:
-        m.update(i)
-    assert m.value == 3
-
-
-def test_min():
-    m = gb.min()
-    for i in [-2, -1, 0, 1, 2, 3]:
-        m.update(i)
-    assert m.value == -2
-
-
-def test_sum():
-    m = gb.sum()
-    L = [-2, -1, 0, 1, 2, 3]
-    for i in L:
-        m.update(i)
-    assert sum(L) == m.value
-
-
-def test_product():
-    m = gb.product()
-    L = [1, 2, 3, 4, 5]
-    x = 1
-    for i in L:
-        m.update(i)
-        x *= i
-    assert x == m.value
-
-
-def test_first_last():
-    a = gb.first()
-    b = gb.last()
-    L = [-2, -1, 0, 1, 2, 3]
-    for i in L:
-        a.update(i)
-        b.update(i)
-    assert a.value == -2
-    assert b.value == 3
-
-
-def test_count():
-    c = gb.count()
-    cu = gb.count_unique()
-    for i in [1, 1, 2, 2]:
-        c.update(i)
-        cu.update(i)
-    assert c.value == 4
-    assert cu.value == 2
-
-
-def test_average():
-    avg = gb.avg()
-    L = [-2, -1, 0, 1, 2, 3]
-    for i in L:
-        avg.update(i)
-    assert avg.value == sum(L) / len(L)
-
-
-def test_average2():
-    avg = gb.avg()
-    L = [0]
-    for i in L:
-        avg.update(i)
-    assert avg.value == sum(L) / len(L)
-
-
-def test_stdev():
-    m = gb.stdev()
-    L = [1, 1]
-    for i in L:
-        m.update(i)
-    assert m.value == 0
-
-    m = gb.stdev()
-    L = [1, 1, 2, 2]
-    for i in L:
-        m.update(i)
-    assert m.value == statistics.stdev(L)
-
-
-def test_mode():
-    def mode(values):
-        m = gb.mode()
-        for i in values:
-            m.update(i)
-        return m.value
-
-    assert mode([1]) == 1
-    assert mode([1, 1, 2]) == 1
-    assert mode([1, 1, 2, 3, 3]) == 3
-    assert mode([1, 1, 2, 2, 3, 3]) == 3
-
-    # raise NotImplementedError("the functions above need verification")
diff --git a/master/tutorial/index.html b/master/tutorial/index.html
index 0dfc0836..38294706 100644
--- a/master/tutorial/index.html
+++ b/master/tutorial/index.html
@@ -783,8 +783,6 @@
         
       
         
-      
-        
       
         
       
@@ -1016,27 +1014,6 @@
   
   
   
-    <li class="md-nav__item">
-      <a href="../reference/groupbys/" class="md-nav__link">
-        
-  
-  <span class="md-ellipsis">
-    Groupbys
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
-            
-              
-                
-  
-  
-  
-  
     <li class="md-nav__item">
       <a href="../reference/import_utils/" class="md-nav__link">
         
diff --git a/versions.json b/versions.json
index 18dba4c4..a814d2a2 100644
--- a/versions.json
+++ b/versions.json
@@ -2,14 +2,14 @@
   {
     "version": "master",
     "title": "master",
-    "aliases": []
+    "aliases": [
+      "latest"
+    ]
   },
   {
     "version": "2023.10.15",
     "title": "2023.10.15",
-    "aliases": [
-      "latest"
-    ]
+    "aliases": []
   },
   {
     "version": "2023.10.14",