add ciel

Author: hamelsmu

fastcore/_nbdev.py

@@ -165,6 +165,7 @@
          "Path.__repr__": "03_xtras.ipynb",
          "truncstr": "03_xtras.ipynb",
          "spark_chars": "03_xtras.ipynb",
+         "ceil": "03_xtras.ipynb",
          "sparkline": "03_xtras.ipynb",
          "autostart": "03_xtras.ipynb",
          "EventTimer": "03_xtras.ipynb",

fastcore/xtras.py

@@ -2,9 +2,9 @@
 
 __all__ = ['dict2obj', 'obj2dict', 'repr_dict', 'is_listy', 'shufflish', 'mapped', 'IterLen', 'ReindexCollection',
            'maybe_open', 'image_size', 'bunzip', 'join_path_file', 'loads', 'loads_multi', 'untar_dir', 'repo_details',
-           'run', 'open_file', 'save_pickle', 'load_pickle', 'truncstr', 'spark_chars', 'sparkline', 'autostart',
-           'EventTimer', 'stringfmt_names', 'PartialFormatter', 'partial_format', 'utc2local', 'local2utc', 'trace',
-           'round_multiple', 'modified_env', 'ContextManagers', 'str2bool', 'sort_by_run']
+           'run', 'open_file', 'save_pickle', 'load_pickle', 'truncstr', 'spark_chars', 'ceil', 'sparkline',
+           'autostart', 'EventTimer', 'stringfmt_names', 'PartialFormatter', 'partial_format', 'utc2local', 'local2utc',
+           'trace', 'round_multiple', 'modified_env', 'ContextManagers', 'str2bool', 'sort_by_run']
 
 # Cell
 from .imports import *
@@ -242,10 +242,12 @@ def truncstr(s:str, maxlen:int, suf:str='…', space='')->str:
 spark_chars = '▁▂▃▅▆▇'
 
 # Cell
-def _sparkchar(x, mn, incr, empty_zero):
+def ceil(x, lim=None): return x if (not lim or x <= lim) else lim
+
+def _sparkchar(x, mn, mx, incr, empty_zero):
     if x is None or (empty_zero and not x): return ' '
     if incr == 0: return spark_chars[0]
-    res = int((x-mn)/incr-0.5)
+    res = int((ceil(x,mx)-mn)/incr-0.5)
     return spark_chars[res]
 
 # Cell
@@ -254,7 +256,7 @@ def sparkline(data, mn=None, mx=None, empty_zero=False):
     valid = [o for o in data if o is not None]
     if not valid: return ' '
     mn,mx,n = ifnone(mn,min(valid)),ifnone(mx,max(valid)),len(spark_chars)
-    res = [_sparkchar(o,mn,(mx-mn)/n,empty_zero) for o in data]
+    res = [_sparkchar(x=o, mn=mn, mx=mx, incr=(mx-mn)/n, empty_zero=empty_zero) for o in data]
     return ''.join(res)
 
 # Cell

nbs/03_xtras.ipynb

@@ -618,7 +618,7 @@
     {
      "data": {
       "text/plain": [
-       "['g', 'a', 'f', 'c', 'e', 'd', 'h', 'b']"
+       "['c', 'g', 'a', 'e', 'b', 'f', 'd', 'h']"
       ]
      },
      "execution_count": null,
@@ -1249,7 +1249,7 @@
     {
      "data": {
       "text/plain": [
-       "Path('.ipynb_checkpoints')"
+       "Path('hamel.py')"
       ]
      },
      "execution_count": null,
@@ -1283,7 +1283,7 @@
     {
      "data": {
       "text/plain": [
-       "(Path('../fastcore/net.py'), Path('03a_parallel.ipynb'))"
+       "(Path('../fastcore/xtras.py'), Path('08_script.ipynb'))"
       ]
      },
      "execution_count": null,
@@ -1400,10 +1400,12 @@
    "outputs": [],
    "source": [
     "#export\n",
-    "def _sparkchar(x, mn, incr, empty_zero):\n",
+    "def ceil(x, lim=None): return x if (not lim or x <= lim) else lim\n",
+    "\n",
+    "def _sparkchar(x, mn, mx, incr, empty_zero):\n",
     "    if x is None or (empty_zero and not x): return ' '\n",
     "    if incr == 0: return spark_chars[0]\n",
-    "    res = int((x-mn)/incr-0.5)\n",
+    "    res = int((ceil(x,mx)-mn)/incr-0.5)\n",
     "    return spark_chars[res]"
    ]
   },
@@ -1419,7 +1421,7 @@
     "    valid = [o for o in data if o is not None]\n",
     "    if not valid: return ' '\n",
     "    mn,mx,n = ifnone(mn,min(valid)),ifnone(mx,max(valid)),len(spark_chars)\n",
-    "    res = [_sparkchar(o,mn,(mx-mn)/n,empty_zero) for o in data]\n",
+    "    res = [_sparkchar(x=o, mn=mn, mx=mx, incr=(mx-mn)/n, empty_zero=empty_zero) for o in data]\n",
     "    return ''.join(res)"
    ]
   },
@@ -1443,6 +1445,33 @@
     "print(f'   with \"empty_zero\": {sparkline(data, empty_zero=True )}')"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "You can set a maximum and minimum for the y-axis of the sparkline with the arguments `mn` and `mx` respectively:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "'▂▅▇▇'"
+      ]
+     },
+     "execution_count": null,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "sparkline([1,2,3,400], mn=0, mx=3)"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,
@@ -1531,8 +1560,8 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Num Events: 3, Freq/sec: 272.3\n",
-      "Most recent:  ▇▁▁▂▁ 460.5 360.2 359.1 391.6 379.3\n"
+      "Num Events: 11, Freq/sec: 394.6\n",
+      "Most recent:  ▇▁▃▁▆ 377.7 299.7 338.0 289.4 361.8\n"
      ]
     }
    ],