Arduino ci (#2)

* add arduino-ci
* add unit test

Author: RobTillaart

.arduino-ci.yml

@@ -0,0 +1,7 @@
+compile:
+  # Choosing to run compilation tests on 2 different Arduino platforms
+  platforms:
+    - uno
+    - leonardo
+    - due
+    - zero

.github/workflows/arduino_test_runner.yml

@@ -0,0 +1,13 @@
+---
+name: Arduino CI
+
+on: [push, pull_request]
+
+jobs:
+  arduino_ci:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+      - uses: Arduino-CI/action@master
+          #   Arduino-CI/[email protected]

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2011-2020 Rob Tillaart
+Copyright (c) 2011-2021 Rob Tillaart
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

MultiMap.h

@@ -1,25 +1,25 @@
 #pragma once
 //
-//    FILE: multimap.h
+//    FILE: MultiMap.h
 //  AUTHOR: Rob Tillaart
-// VERSION: 0.1.2
+// VERSION: 0.1.3
 //    DATE: 2011-01-26
 // PURPOSE: Arduino library for fast non-linear mapping or interpolation of values
 //     URL: https://github.com/RobTillaart/MultiMap
 //     URL: http://playground.arduino.cc/Main/MultiMap
 //
-// HISTORY:
-// 0.0.1    2011-01-26 initial version (see forum)
-// .....
-// 0.1.0    2015-03-29
-// 0.1.1    2020-04-09
-// 0.1.2    2020-06-19 fix library.json
-//
+//  HISTORY:
+//  0.0.1   2011-01-26 initial version (see forum)
+//  .....
+//  0.1.0   2015-03-29
+//  0.1.1   2020-04-09
+//  0.1.2   2020-06-19  fix library.json
+//  0.1.3   2021-01-02  add arduino-CI 
 //
 
-#define MULTIMAP_LIB_VERSION "0.1.2"
+#define MULTIMAP_LIB_VERSION "0.1.3"
 
-#include <Arduino.h>
+#include "Arduino.h"
 
 // note: the in array should have increasing values
 template<typename T>
@@ -44,46 +44,49 @@ T multiMap(T val, T* _in, T* _out, uint8_t size)
 
 /*
  * speed optimized version if inputs do not change often e.g.  2 2 2 2 2 3 3 3 3 5 5 5 5 5 5 8 8 8 8 5 5 5 5 5 
- * 
+ *
 // note: the in array should have increasing values
+
 template<typename T>
 T multiMap(T val, T* _in, T* _out, uint8_t size)
 {
-    
-    static T lastvalue = -1;
-    static T cache = -1;	
-	
-	if (val == lastvalue) return cache;
-	lastvalue = val;
+  static T lastvalue = -1;
+  static T cache = -1;  
 
-    // take care the value is within range
-    // val = constrain(val, _in[0], _in[size-1]);
-    if (val <= _in[0])
-	{
-		cache = _out[0];
-	}
-    else if (val >= _in[size-1])
-	{
-		cache = _out[size-1];
-	}
+  if (val == lastvalue)
+  {
+    return cache;
+  }
+  lastvalue = val;
+
+  // take care the value is within range
+  // val = constrain(val, _in[0], _in[size-1]);
+  if (val <= _in[0])
+  {
+    cache = _out[0];
+  }
+  else if (val >= _in[size-1])
+  {
+    cache = _out[size-1];
+  }
+  else
+  {
+    // search right interval; index 0 _in[0] already tested
+    uint8_t pos = 1;  
+    while(val > _in[pos]) pos++;
+    
+    // this will handle all exact "points" in the _in array
+    if (val == _in[pos]) 
+    {
+      cache = _out[pos];
+    }
     else
-	{
-        // search right interval; index 0 _in[0] already tested
-        uint8_t pos = 1;  
-        while(val > _in[pos]) pos++;
-	    
-        // this will handle all exact "points" in the _in array
-        if (val == _in[pos]) 
-        {
-		    cache = _out[pos];
-        }
-		else
-		{
-		    // interpolate in the right segment for the rest
-            cache = (val - _in[pos-1]) * (_out[pos] - _out[pos-1]) / (_in[pos] - _in[pos-1]) + _out[pos-1];
-		}
-	}
-	return cache;
+    {
+      // interpolate in the right segment for the rest
+      cache = (val - _in[pos-1]) * (_out[pos] - _out[pos-1]) / (_in[pos] - _in[pos-1]) + _out[pos-1];
+    }
+  }
+  return cache;
 }
 */
 

README.md

@@ -1,3 +1,8 @@
+
+[![Arduino CI](https://github.com/RobTillaart/MultiMap/workflows/Arduino%20CI/badge.svg)](https://github.com/marketplace/actions/arduino_ci)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/RobTillaart/MultiMap/blob/master/LICENSE)
+[![GitHub release](https://img.shields.io/github/release/RobTillaart/MultiMap.svg?maxAge=3600)](https://github.com/RobTillaart/MultiMap/releases)
+
 # MultiMap
 
 Arduino library for fast non-linear mapping or interpolation of values
@@ -7,27 +12,28 @@ Arduino library for fast non-linear mapping or interpolation of values
 In Arduino applications often the value of a sensor is mapped upon a more
 usable value. E.g. the value of analogRead() is mapped onto 0 .. 5.0 Volt.
 This is done by the map function which does a linear interpolation. This means
-```
+
+```cpp
     output = C1 + input * C2
 ```
+
 As C1 and C2 are to be calculated Arduino has the **map()** that calculates the 
 two variables runtime from two given mappings.
-```
+
+```cpp
     output = map(input, I1, I2, O1, O2):
 ```
 
-In many cases when there is no linear mapping possible, as the 'points' are not on a single line,
-one needs non-linear math to calculate the output. **Multimap()** just does that.
+In many cases when there is no linear mapping possible, as the 'points' are not on a single line.
+One needs non-linear math to calculate the output, **Multimap()** just does that.
 
-**Multimap()** needs two equal sized arrays of 'points', **input\[\]** and **output\[\]**, it looks up the 
+**out = Multimap(value, input, output, size)** needs two equal sized arrays of reference 'points', **input\[\]** and **output\[\]**, it looks up the 
 input value in the input\[\] array and if needed it linear interpolates between two
 points of the output\[\] array. 
 
-The **input\[\]** array must have increasing values,
+- The **input\[\]** array must have increasing values,
 there is no such restriction for the **output\[\]** array.
-
-**Multimap()** automatically constrains the output to the first and last 
-value in the **output\[\]** array.
+- **Multimap()** automatically constrains the output to the first and last value in the **output\[\]** array.
 
 ## Operation
 

examples/multimap_NTC/multimap_NTC.ino

@@ -1,13 +1,13 @@
 //
 //    FILE: multimap_NTC.ino
 //  AUTHOR: Rob Tillaart
-// VERSION: 0.1.0
+// VERSION: 0.1.1
 // PURPOSE: demo
 //    DATE: 2020-04-09
 //    (c) : MIT
 //
 
-#include "multimap.h"
+#include "MultiMap.h"
 
 uint32_t start;
 uint32_t stop;

examples/multimap_NTC_int_FAIL/multimap_NTC_int_FAIL.ino

@@ -1,7 +1,7 @@
 //
 //    FILE: multimap_NTC_int_FAIL.ino
 //  AUTHOR: Rob Tillaart
-// VERSION: 0.1.0
+// VERSION: 0.1.1
 // PURPOSE: demo of faulty optimizing 
 //    DATE: 2020-04-09
 //    (c) : MIT
@@ -16,7 +16,7 @@
 // 
 
 
-#include "multimap.h"
+#include "MultiMap.h"
 
 uint32_t start;
 uint32_t stop;

examples/multimap_distance/multimap_distance.ino

@@ -2,12 +2,12 @@
 //
 //    FILE: multimap_distance.ino
 //  AUTHOR: Rob Tillaart
-// VERSION: 0.1.0
+// VERSION: 0.1.1
 // PURPOSE: demo
 //    DATE: 2020-04-09
 //
 
-#include "multimap.h"
+#include "MultiMap.h"
 
 void setup()
 {

examples/multimap_functions/multimap_functions.ino

@@ -1,14 +1,14 @@
 //
 //    FILE: multimap_functions.ino
 //  AUTHOR: Rob Tillaart
-// VERSION: 0.1.0
+// VERSION: 0.1.1
 // PURPOSE: demo (use serial plotter)...
 //    DATE: 2020-04-09
 //    (c) : MIT
 //
 
 
-#include "multimap.h"
+#include "MultiMap.h"
 
 void setup()
 {

examples/multimap_timing/multimap_timing.ino

@@ -1,14 +1,14 @@
 //
 //    FILE: multimap_timing.ino
 //  AUTHOR: Rob Tillaart
-// VERSION: 0.1.0
+// VERSION: 0.1.1
 // PURPOSE: demo
 //    DATE: 2020-04-09
 //    (c) : MIT
 //
 
 
-#include "multimap.h"
+#include "MultiMap.h"
 
 int in[] =  { 11,  22,  33};
 int out[] = {111, 222, 555};