numberdividend 0.1.2

A tool for dividend distribution analysis.

NumberDividend

A simple Python package to split a list of numbers so that their sum matches a target value.

Installation

pip install numberdividend

Usage

You can use it as a module:

from numberdividend import NumberCore

array = [1, 2, 3, 5, 6]

div = NumberCore.dividend(array, 900, 3, 5)
NumberCore.display(div)

---

NumberCore.dividend(array, target_sum, limit, decimal)

Calculate the dividend distribution of an array.

Value	Type	Description
array	List[float]	List of float numbers to be distributed.
target_sum	float	Target sum for the distribution.
limit	int, optional	Maximum number of elements to consider from the array.
decimal	int, optional	Number of decimal places for the output.
return	List[Tuple[float, float]]	List of tuples containing the index and the dividend value

---

NumberCore.display(array)

Display the dividend distribution using matplotlib.

Value	Type	Description
array	List[float]	List of dividend values to be displayed.

---

CLI Usage

python -m numberdividend C:\User\path\...\input.csv 300 C:\User\path\...\output.csv --limit 30 --display

⚠️ Only .csv files are supported as input. Structure of input.csv:

No column name
1
2
3
5
9

---

Command struct

Value	Type	Description
path	str	Input file path
target	int	Value of sum the array
save	str	Output file path
--limit	int	Optional limit on the number of elements considered
--display	none	Optional displays the processed array

License

MIT

Author

Sabolch - Github profile