Difference between revisions of "Component: Map Function (Calculation)"
From Flowcode Help
Jump to navigationJump to search| (10 intermediate revisions by 2 users not shown) | |||
| Line 14: | Line 14: | ||
==Map Function component== | ==Map Function component== | ||
The map function is intended to change one range of values into another range of values. For example. Output from a temperature sensor is in centigrade. you can map it to give the result in Fahrenheit. To do that set: InMin to 0, InMax 100, OutMin to 32 & OutMax to 212 | The map function is intended to change one range of values into another range of values. For example. Output from a temperature sensor is in centigrade. you can map it to give the result in Fahrenheit. To do that set: InMin to 0, InMax 100, OutMin to 32 & OutMax to 212 | ||
| − | |||
| − | |||
| − | |||
| − | |||
==Detailed description== | ==Detailed description== | ||
| Line 25: | Line 21: | ||
| − | |||
| − | |||
| Line 33: | Line 27: | ||
| − | '' | + | ''No detailed description exists yet for this component'' |
| − | == | + | ==Examples== |
| − | + | A simple example showing how to take a value from an adc input with the range 0-255 and mapping this to a predetermined range of 50-150 to drive a PWM output. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| + | {{Fcfile|MappingADCtoPWM.fcfx|Mapping ADC to PWM}} | ||
| − | + | ==Macro reference== | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| + | ===MapByte=== | ||
{| class="wikitable" style="width:60%; background-color:#FFFFFF;" | {| class="wikitable" style="width:60%; background-color:#FFFFFF;" | ||
|- | |- | ||
| Line 295: | Line 81: | ||
| − | + | ===MapFloat=== | |
| − | |||
| − | == | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
{| class="wikitable" style="width:60%; background-color:#FFFFFF;" | {| class="wikitable" style="width:60%; background-color:#FFFFFF;" | ||
|- | |- | ||
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]] | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]] | ||
| − | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | ''' | + | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''MapFloat''' |
|- | |- | ||
| − | | colspan="2" | Map function for | + | | colspan="2" | Map function for floating point type variables |
|- | |- | ||
|- | |- | ||
| − | | width="10%" align="center" | [[File:Fc9- | + | | width="10%" align="center" | [[File:Fc9-f32-icon.png]] - FLOAT |
| width="90%" | Value | | width="90%" | Value | ||
|- | |- | ||
| colspan="2" | Main variable used for map function | | colspan="2" | Main variable used for map function | ||
|- | |- | ||
| − | | width="10%" align="center" | [[File:Fc9- | + | | width="10%" align="center" | [[File:Fc9-f32-icon.png]] - FLOAT |
| width="90%" | InMin | | width="90%" | InMin | ||
|- | |- | ||
| colspan="2" | Lowest input value | | colspan="2" | Lowest input value | ||
|- | |- | ||
| − | | width="10%" align="center" | [[File:Fc9- | + | | width="10%" align="center" | [[File:Fc9-f32-icon.png]] - FLOAT |
| width="90%" | InMax | | width="90%" | InMax | ||
|- | |- | ||
| colspan="2" | Highest value input | | colspan="2" | Highest value input | ||
|- | |- | ||
| − | | width="10%" align="center" | [[File:Fc9- | + | | width="10%" align="center" | [[File:Fc9-f32-icon.png]] - FLOAT |
| width="90%" | OutMin | | width="90%" | OutMin | ||
|- | |- | ||
| colspan="2" | Lowest value after conversion | | colspan="2" | Lowest value after conversion | ||
|- | |- | ||
| − | | width="10%" align="center" | [[File:Fc9- | + | | width="10%" align="center" | [[File:Fc9-f32-icon.png]] - FLOAT |
| width="90%" | OutMax | | width="90%" | OutMax | ||
|- | |- | ||
| Line 344: | Line 120: | ||
| colspan="2" | Clamp min & max so result does not go above or below set values. 0=No, 1=Yes | | colspan="2" | Clamp min & max so result does not go above or below set values. 0=No, 1=Yes | ||
|- | |- | ||
| − | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9- | + | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-f32-icon.png]] - FLOAT |
| width="90%" style="border-top: 2px solid #000;" | ''Return'' | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
|} | |} | ||
| + | ===MapInt=== | ||
{| class="wikitable" style="width:60%; background-color:#FFFFFF;" | {| class="wikitable" style="width:60%; background-color:#FFFFFF;" | ||
|- | |- | ||
| Line 392: | Line 169: | ||
| − | + | ===MapLong=== | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
{| class="wikitable" style="width:60%; background-color:#FFFFFF;" | {| class="wikitable" style="width:60%; background-color:#FFFFFF;" | ||
|- | |- | ||
| Line 478: | Line 213: | ||
| + | ===MapUInt=== | ||
{| class="wikitable" style="width:60%; background-color:#FFFFFF;" | {| class="wikitable" style="width:60%; background-color:#FFFFFF;" | ||
|- | |- | ||
| Line 521: | Line 257: | ||
| + | ===MapUlong=== | ||
{| class="wikitable" style="width:60%; background-color:#FFFFFF;" | {| class="wikitable" style="width:60%; background-color:#FFFFFF;" | ||
|- | |- | ||
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]] | | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]] | ||
| − | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | ''' | + | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''MapUlong''' |
|- | |- | ||
| − | | colspan="2" | Map function for | + | | colspan="2" | Map function for unsigned long type variables |
|- | |- | ||
|- | |- | ||
| − | | width="10%" align="center" | [[File:Fc9- | + | | width="10%" align="center" | [[File:Fc9-u32-icon.png]] - ULONG |
| width="90%" | Value | | width="90%" | Value | ||
|- | |- | ||
| colspan="2" | Main variable used for map function | | colspan="2" | Main variable used for map function | ||
|- | |- | ||
| − | | width="10%" align="center" | [[File:Fc9- | + | | width="10%" align="center" | [[File:Fc9-u32-icon.png]] - ULONG |
| width="90%" | InMin | | width="90%" | InMin | ||
|- | |- | ||
| colspan="2" | Lowest input value | | colspan="2" | Lowest input value | ||
|- | |- | ||
| − | | width="10%" align="center" | [[File:Fc9- | + | | width="10%" align="center" | [[File:Fc9-u32-icon.png]] - ULONG |
| width="90%" | InMax | | width="90%" | InMax | ||
|- | |- | ||
| colspan="2" | Highest value input | | colspan="2" | Highest value input | ||
|- | |- | ||
| − | | width="10%" align="center" | [[File:Fc9- | + | | width="10%" align="center" | [[File:Fc9-u32-icon.png]] - ULONG |
| width="90%" | OutMin | | width="90%" | OutMin | ||
|- | |- | ||
| colspan="2" | Lowest value after conversion | | colspan="2" | Lowest value after conversion | ||
|- | |- | ||
| − | | width="10%" align="center" | [[File:Fc9- | + | | width="10%" align="center" | [[File:Fc9-u32-icon.png]] - ULONG |
| width="90%" | OutMax | | width="90%" | OutMax | ||
|- | |- | ||
| Line 559: | Line 296: | ||
| colspan="2" | Clamp min & max so result does not go above or below set values. 0=No, 1=Yes | | colspan="2" | Clamp min & max so result does not go above or below set values. 0=No, 1=Yes | ||
|- | |- | ||
| − | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9- | + | | width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u32-icon.png]] - ULONG |
| width="90%" style="border-top: 2px solid #000;" | ''Return'' | | width="90%" style="border-top: 2px solid #000;" | ''Return'' | ||
|} | |} | ||
| − | |||
| − | |||
| Line 574: | Line 309: | ||
|- | |- | ||
|} | |} | ||
| + | |||
| + | ==Component Source Code== | ||
| + | |||
| + | Please click here to download the component source project: [https://www.flowcode.co.uk/wiki/componentsource/FC_Comp_Source_Map-Function.fcfx FC_Comp_Source_Map-Function.fcfx] | ||
| + | |||
| + | Please click here to view the component source code (Beta): [https://www.flowcode.co.uk/FlowchartView/?wfile=componentsource/FC_Comp_Source_Map-Function.fcfx FC_Comp_Source_Map-Function.fcfx] | ||
Latest revision as of 08:59, 9 June 2025
| Author | medelec35 |
| Version | 2.0 |
| Category | Calculation |
Contents
Map Function component
The map function is intended to change one range of values into another range of values. For example. Output from a temperature sensor is in centigrade. you can map it to give the result in Fahrenheit. To do that set: InMin to 0, InMax 100, OutMin to 32 & OutMax to 212
Detailed description
No detailed description exists yet for this component
Examples
A simple example showing how to take a value from an adc input with the range 0-255 and mapping this to a predetermined range of 50-150 to drive a PWM output.
Macro reference
MapByte
|
MapByte |
| Map function for byte type variables | |
 - BYTE
|
Value |
| Main variable used for map function | |
| - BYTE
|
InMin |
| Lowest input value | |
| - BYTE
|
InMax |
| Highest value input | |
| - BYTE
|
OutMin |
| Lowest value after conversion | |
| - BYTE
|
OutMax |
| highest value after conversion | |
 - BOOL
|
ClampMinMax |
| Clamp min & max so result does not go above or below set values. 0=No, 1=Yes | |
| - BYTE
|
Return |
MapFloat
|
|
MapFloat |
| Map function for floating point type variables | |
 - FLOAT
|
Value |
| Main variable used for map function | |
| - FLOAT
|
InMin |
| Lowest input value | |
| - FLOAT
|
InMax |
| Highest value input | |
| - FLOAT
|
OutMin |
| Lowest value after conversion | |
| - FLOAT
|
OutMax |
| highest value after conversion | |
| - BOOL
|
ClampMinMax |
| Clamp min & max so result does not go above or below set values. 0=No, 1=Yes | |
| - FLOAT
|
Return |
MapInt
|
|
MapInt |
| Map function for signed int type variables | |
 - INT
|
Value |
| Main variable used for map function | |
| - INT
|
InMin |
| Lowest input value | |
| - INT
|
InMax |
| Highest value input | |
| - INT
|
OutMin |
| Lowest value after conversion | |
| - INT
|
OutMax |
| highest value after conversion | |
| - BOOL
|
ClampMinMax |
| Clamp min & max so result does not go above or below set values. 0=No, 1=Yes | |
| - INT
|
Return |
MapLong
|
|
MapLong |
| Map function for signed long type variables | |
 - LONG
|
Value |
| Main variable used for map function | |
| - LONG
|
InMin |
| Lowest input value | |
| - LONG
|
InMax |
| Highest value input | |
| - LONG
|
OutMin |
| Lowest value after conversion | |
| - LONG
|
OutMax |
| highest value after conversion | |
| - BOOL
|
ClampMinMax |
| Clamp min & max so result does not go above or below set values. 0=No, 1=Yes | |
| - LONG
|
Return |
MapUInt
|
|
MapUInt |
| Map function for unsigned int type variables | |
 - UINT
|
Value |
| Main variable used for map function | |
| - UINT
|
InMin |
| Lowest input value | |
| - UINT
|
InMax |
| Highest value input | |
| - UINT
|
OutMin |
| Lowest value after conversion | |
| - UINT
|
OutMax |
| highest value after conversion | |
| - BOOL
|
ClampMinMax |
| Clamp min & max so result does not go above or below set values. 0=No, 1=Yes | |
| - UINT
|
Return |
MapUlong
|
|
MapUlong |
| Map function for unsigned long type variables | |
 - ULONG
|
Value |
| Main variable used for map function | |
| - ULONG
|
InMin |
| Lowest input value | |
| - ULONG
|
InMax |
| Highest value input | |
| - ULONG
|
OutMin |
| Lowest value after conversion | |
| - ULONG
|
OutMax |
| highest value after conversion | |
| - BOOL
|
ClampMinMax |
| Clamp min & max so result does not go above or below set values. 0=No, 1=Yes | |
| - ULONG
|
Return |
Property reference
|
Properties |
Component Source Code
Please click here to download the component source project: FC_Comp_Source_Map-Function.fcfx
Please click here to view the component source code (Beta): FC_Comp_Source_Map-Function.fcfx
