PymateIO-mapping - Revision history

Dodomi: /* Example 1 */

2026-09-11T22:40:41Z

Example 1

← Older revision		Revision as of 00:40, 12 September 2026
Line 48:		Line 48:

	<syntaxhighlight lang="python" line>		<syntaxhighlight lang="python" line>
			from maps import ranking

	result = ranking( val, [10,20,30,40] )		result = ranking( val, [10,20,30,40] )
	</syntaxhighlight>		</syntaxhighlight>

Dodomi: /* Example 2 */

2026-09-11T22:40:30Z

Example 2

← Older revision		Revision as of 00:40, 12 September 2026
Line 59:		Line 59:
	=== Example 2 ===		=== Example 2 ===
	<syntaxhighlight lang="python" line>		<syntaxhighlight lang="python" line>
			from maps import ranking

	result = ranking( val, [10,20,30,40], ["A", "B", "C", "D"] )		result = ranking( val, [10,20,30,40], ["A", "B", "C", "D"] )
	</syntaxhighlight>		</syntaxhighlight>

Dodomi: /* slice_by() function */

2026-09-11T22:40:01Z

slice_by() function

← Older revision		Revision as of 00:40, 12 September 2026
Line 70:		Line 70:
	== slice_by() function ==		== slice_by() function ==

	~~La fonction `~~slice_by()~~` permet diviser un liste en sous~~-~~listes de~~ N ~~éléments~~.		It exists situation where you need to split a long list into smaller sub-lists of a given length.

			It is the purpose of the {{fname\|slice_by()}} function creating a list of sub-list each having N items.

	<nowiki>def slice_by( lst, by_len ):</nowiki>		<nowiki>def slice_by( lst, by_len ):</nowiki>

	~~where~~:		{{underline\|Function parameters:}}

	* ~~__lst__~~ : ~~la liste~~ source.		* '''lst''' : the source list.
	* ~~__by_len__~~ : ~~le nombre d'élément dans chaque sous~~-~~liste~~.		* '''by_len''' : the split length of the sub-lists.


	~~Exemple:~~		=== Example 1 ===
	~~```~~ python		<syntaxhighlight lang="python" line>
	from maps import slice_by		from maps import slice_by

	l = [1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26]		l = [1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26]
	print( "slice by 5", slice_by(l,5) )		print( "slice by 5", slice_by(l,5) )
	~~```~~		</syntaxhighlight>

	~~ce qui affiche le resultat suivant:~~		which prints the following

	~~```~~		<nowiki>slice by 5 [[1, 2, 3, 4, 5], [6, 7, 8, 9, 10],
	slice by 5 [[1, 2, 3, 4, 5], [6, 7, 8, 9, 10], [11, 12, 13, 14, 15], [16, 17, 18, 19, 20], [21, 22, 23, 24, 25], [26]]		[11, 12, 13, 14, 15], [16, 17, 18, 19, 20],
	~~```~~		[21, 22, 23, 24, 25], [26]]</nowiki>

Dodomi: /* ranking() function */

2026-09-11T22:34:12Z

ranking() function

← Older revision		Revision as of 00:34, 12 September 2026
Line 35:		Line 35:
	<nowiki>def ranking( value, ranges, transposed=None ):</nowiki>		<nowiki>def ranking( value, ranges, transposed=None ):</nowiki>

	~~with~~:		{{underline\|Function parameters:}}

	* '''value''' : the input value compared to the various ranges. When falling into a range, the resulting output value is the lower value of the range (or corresponding ''transposed'' value when defined). '''None''' is return when the input value is below the very first range.		* '''value''' : the input value compared to the various ranges. When falling into a range, the resulting output value is the lower value of the range (or corresponding ''transposed'' value when defined). '''None''' is return when the input value is below the very first range.
Line 41:		Line 41:
	* '''transposed''' : (optional) list of transposed value for each entry of the ranges list. When defined, the resulting output (lower value of the range) is replaced with the corresponding entry from the '''transposed''' list.		* '''transposed''' : (optional) list of transposed value for each entry of the ranges list. When defined, the resulting output (lower value of the range) is replaced with the corresponding entry from the '''transposed''' list.

	results:		{{underline\|Function results:}}

	The lower value of the range within the input value falls otherwise `None` when the input value do not fit any range. The resulting value can be replace with its `transposed` equivalent (when `transposed` is defined).		The lower value of the range within the input value falls otherwise `None` when the input value do not fit any range. The resulting value can be replace with its `transposed` equivalent (when `transposed` is defined).

Dodomi: /* map() function */

2026-09-11T22:33:29Z

map() function

← Older revision		Revision as of 00:33, 12 September 2026
Line 15:		Line 15:
	<nowiki>def map(value, istart, istop, ostart, ostop):</nowiki>		<nowiki>def map(value, istart, istop, ostart, ostop):</nowiki>

	Function parameters:		{{underline\|Function parameters:}}

	* '''value''' : The input value (integer or float) within the range istart..istop.		* '''value''' : The input value (integer or float) within the range istart..istop.
Line 23:		Line 23:
	* '''ostop''' : maximal value of the output range (integer or float).		* '''ostop''' : maximal value of the output range (integer or float).

	Function results:		{{underline\|Function results:}}

	The function will returns the output value (a float) in the range ostart..ostop. It is the resulting value corresponding to the input '''value''' .		The function will returns the output value (a float) in the range ostart..ostop. It is the resulting value corresponding to the input '''value''' .

Dodomi: /* map() function */

2026-09-11T22:33:02Z

map() function

← Older revision		Revision as of 00:33, 12 September 2026
Line 15:		Line 15:
	<nowiki>def map(value, istart, istop, ostart, ostop):</nowiki>		<nowiki>def map(value, istart, istop, ostart, ostop):</nowiki>

	~~with~~:		Function parameters:

	* '''value''' : The input value (integer or float) within the range istart..istop.		* '''value''' : The input value (integer or float) within the range istart..istop.
Line 23:		Line 23:
	* '''ostop''' : maximal value of the output range (integer or float).		* '''ostop''' : maximal value of the output range (integer or float).

	~~Results~~:		Function results:

	The function will returns the output value (a float) in the range ostart..ostop. It is the resulting value corresponding to the input ~~__value__~~ .		The function will returns the output value (a float) in the range ostart..ostop. It is the resulting value corresponding to the input '''value''' .

	== ranking() function ==		== ranking() function ==

Dodomi: /* ranking() function */

2026-09-11T22:32:12Z

ranking() function

← Older revision		Revision as of 00:32, 12 September 2026
Line 45:		Line 45:
	The lower value of the range within the input value falls otherwise `None` when the input value do not fit any range. The resulting value can be replace with its `transposed` equivalent (when `transposed` is defined).		The lower value of the range within the input value falls otherwise `None` when the input value do not fit any range. The resulting value can be replace with its `transposed` equivalent (when `transposed` is defined).

	Example:		=== Example 1 ===

	<syntaxhighlight lang="python" line>		<syntaxhighlight lang="python" line>
Line 57:		Line 57:
	* will returns 40 for val>= 40		* will returns 40 for val>= 40

			=== Example 2 ===
	<syntaxhighlight lang="python" line>		<syntaxhighlight lang="python" line>
	result = ranking( val, [10,20,30,40], ["A", "B", "C", "D"] )		result = ranking( val, [10,20,30,40], ["A", "B", "C", "D"] )

Dodomi: /* ranking() function */

2026-09-11T22:30:44Z

ranking() function

← Older revision		Revision as of 00:30, 12 September 2026
Line 37:		Line 37:
	with:		with:

	* '''value''' : the input value compared to the various ranges. When falling into a range, the resulting output value is the lower value of the range (or corresponding ~~__transposed__~~ value when defined). ~~___None___~~ is return when the input value is below the very first range.		* '''value''' : the input value compared to the various ranges. When falling into a range, the resulting output value is the lower value of the range (or corresponding ''transposed'' value when defined). '''None''' is return when the input value is below the very first range.
	* '''ranges''' : list of increasing values defining the n ranges. Ranges can be read as follows range[0]..range[1], range[1]..range[2], range[2]..range[3], ... range[n-1]..range[n]		* '''ranges''' : list of increasing values defining the n ranges. Ranges can be read as follows range[0]..range[1], range[1]..range[2], range[2]..range[3], ... range[n-1]..range[n]
	* '''transposed''' : (~~optionnel~~) ~~liste des valeurs transposées correspondant à aux intervalles~~. ~~Si définit c~~'~~est la valeur transposée qui est retournée n lieu et place de la borne inférieure de l~~'~~intervalle~~.		* '''transposed''' : (optional) list of transposed value for each entry of the ranges list. When defined, the resulting output (lower value of the range) is replaced with the corresponding entry from the '''transposed''' list.

	~~retourne~~:		results:

	~~La borne inférieure de l'intervalle dans lequel la valeur `~~value~~` tombe ou~~ `None`. ~~Si une liste de valeurs transposée existe alors le résultat~~ (~~borne inférieure) est extrait de la liste~~ `transposed` ~~avant d'être retourné~~		The lower value of the range within the input value falls otherwise `None` when the input value do not fit any range. The resulting value can be replace with its `transposed` equivalent (when `transposed` is defined).

	~~Exemple~~:		Example:
	~~```~~
			<syntaxhighlight lang="python" line>
	result = ranking( val, [10,20,30,40] )		result = ranking( val, [10,20,30,40] )
	~~```~~		</syntaxhighlight>

	* ~~retourne~~ None si val < 10		* will returns None for val < 10
	* ~~retourne~~ 10 si val>= 10 et val < 20		* will returns 10 for val>= 10 and val < 20
	* ~~retourne~~ 20 si val>= 20 et val < 30		* will returns 20 for val>= 20 and val < 30
	* ~~retourne~~ 30 si val>= 30 et val < 40		* will returns 30 for val>= 30 and val < 40
	* ~~retourne~~ 40 si val>= 40		* will returns 40 for val>= 40

	~~```~~		<syntaxhighlight lang="python" line>
	result = ranking( val, [10,20,30,40], ["A", "B", "C", "D"] )		result = ranking( val, [10,20,30,40], ["A", "B", "C", "D"] )
	~~```~~		</syntaxhighlight>

	* retourne None si val < 10
	* retourne "A" si val>~~= 10 et val < 20~~
	* retourne "B" si val>= 20 et val < 30
	* retourne "C" si val>= 30 et val < 40
	* retourne "D" si val>= 40

	~~remarks: l'appel pourrait également être écrit `result~~ = ~~ranking(~~ val~~, [10,~~20,30,40], "~~ABCD~~" )`		* will returns None for val < 10
			* will returns "A" for val>= 10 and val < 20
			* will returns "B" for val>= 20 and val < 30
			* will returns "C" for val>= 30 and val < 40
			* will returns "D" for val>= 40

	== slice_by() function ==		== slice_by() function ==

Dodomi: /* ranking() function */

2026-09-11T21:29:04Z

ranking() function

← Older revision		Revision as of 23:29, 11 September 2026
Line 29:		Line 29:
	== ranking() function ==		== ranking() function ==

	~~La fonction `~~ranking()~~` permet de catégoriser facilement une valeur d'entrée parmi une liste de valeurs précisée dans `~~ranges`. ~~La fonction permet également de transposer la valeur catégorisée avec une des valeurs de sortie mentionnées dans `transposed`~~ (~~si celui-ci est défini~~).		The {{fname\|ranking()}} function is used to categorize an input value within a limited set of {{fname\|ranges}}.

			The function can also transpose the categorized value with a list of output values (when defined in the call).

	<nowiki>def ranking( value, ranges, transposed=None ):</nowiki>		<nowiki>def ranking( value, ranges, transposed=None ):</nowiki>

	~~avec~~:		with:

	* ~~__value__~~ : ~~valeur comparée aux différents intervalles~~. ~~Lorsqu'une valeur tombe dans un intervalle~~, ~~la limite inférieure de celui-ci est retourné~~ (~~ou valeur transposée correspondante~~). ~~`None` est retourné si `~~value~~` est en dessous du premier intervalle~~.		* '''value''' : the input value compared to the various ranges. When falling into a range, the resulting output value is the lower value of the range (or corresponding __transposed__ value when defined). ___None___ is return when the input value is below the very first range.
	* ~~__ranges__~~ : ~~liste des valeurs croissantes définissant les~~ n ~~intervalles~~.		* '''ranges''' : list of increasing values defining the n ranges. Ranges can be read as follows range[0]..range[1], range[1]..range[2], range[2]..range[3], ... range[n-1]..range[n]
	* ~~__transposed__~~ : (optionnel) liste des valeurs transposées correspondant à aux intervalles. Si définit c'est la valeur transposée qui est retournée n lieu et place de la borne inférieure de l'intervalle.		* '''transposed''' : (optionnel) liste des valeurs transposées correspondant à aux intervalles. Si définit c'est la valeur transposée qui est retournée n lieu et place de la borne inférieure de l'intervalle.

	retourne:		retourne:

Dodomi: /* map() function */

2026-09-11T20:28:34Z

map() function

← Older revision		Revision as of 22:28, 11 September 2026
Line 15:		Line 15:
	<nowiki>def map(value, istart, istop, ostart, ostop):</nowiki>		<nowiki>def map(value, istart, istop, ostart, ostop):</nowiki>

	~~avec~~:		with:

	* ~~__value__~~ : ~~valeur d'entrée~~ (~~entier ou~~ float) ~~située entre un minimum `~~istart~~` et un maximum `~~istop`.		* '''value''' : The input value (integer or float) within the range istart..istop.
	* ~~__istart__~~ : ~~valeur minimale de la plage d'entrée~~ (~~entier ou~~ float).		* '''istart''' : minimal value of input range (integer or float).
	* ~~__istop__~~ : ~~valeur maximale de la plage d'entrée~~ (~~entier ou~~ float).		* '''istop''' : maximal value of the input range (integer or float).
	* ~~__ostart__~~ : ~~borne inférieure de la valeur de sortie~~ (~~entier ou~~ float).		* '''ostart''' : minimal value of output range (integer or float).
	* ~~__ostop__~~ : ~~borne supérieur de la valeur de sortie~~ (~~entier ou~~ float).		* '''ostop''' : maximal value of the output range (integer or float).

	~~retourne~~:		Results:

	~~La fonction retourne la valeur de sortie~~ (float) ~~correspondant à la valeur d'entrée `~~value`		The function will returns the output value (a float) in the range ostart..ostop. It is the resulting value corresponding to the input __value__ .

	== ranking() function ==		== ranking() function ==