Welcome to dumbpy

2025-26 DSCI-524 Group 18

About dumbpy

DumbPy is an alternative version of NumPy, which facilitates scientific computing using Python. DumbPy contains numeric functions that provide useful summary statistics of numerical lists, listed below. DumbPy additionally carries out strict input testing to provide clear and user-friendly error messages and facilitate proper usage.

DumbPy Functions:

• support_functions - these functions will test the inputted object, and will catch any input besides a list of numbers and produce suitable error messages. Additionally, there will be a helper function that will take user input on whether to flatten an inputted list of lists into one list.

• arithmetic_mean - the mean function will calculate and return the mean, or the average, of the inputted numerical list.

• std_deviation - the standard deviation function will calculate and return the standard deviation of the inputted numerical list.

• median - the median function will calculate and return the median value of the inputted numerical list

As stated above, the NumPy package already exists and provides similar functions. NumPy can be found at the following link: https://numpy.org/. DumbPy is an alternative version, which is much simpler and has a narrower focus.

Relevant links

• Documentation
• Test-PyPI

Get started

You can install this package into your preferred Python environment using pip (we don't have it pushed to PyPI, we need to use Test):

pip install -i https://test.pypi.org/simple/ dumbpy

To use dumbpy in your code:

>>> import dumbpy
>>> dumbpy.arithmetic_mean([1,2,3])
2.0

Contributors

• Hector Palafox
• Nicole Link
• Samrawit Mezgebo

Development

1) Clone the repository

git clone https://github.com/UBC-MDS/dumbpy.git
cd dumbpy

2) Create the conda environment

conda env create -f environment.yml

3) Activate the environment

conda activate dumbpy-env

4) Install the package locally

python -m pip install -e .

5) Run the test suite

pytest

6) Build the documentation

cd docs
quarto render

7) Preview the documentation locally(optional)

quarto preview

Docs are deployed automatically via GitHub Actions on merges to the deployment branch.

Deployed docs: dumpy documentation

Copyright

• Copyright © 2026 Hector Palafox, Nicole Link, Samrawit Mezgebo.
• Free software distributed under the MIT License.