numberdividend 0.1.1

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)
NumberCore.display(div)

---

NumberCore.dividend(array, target_sum, limit)

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.
return	List[Tuple[int, 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